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fer than ever before! 


flash because your compil- 
ing horsepower is better 
than 27,000 lines a min- 
ute.* And 4.0 also includes 
an automatic project Make. 


Pr a 





4.0 uses logical 
units for separate 
compilation 


Pascal 4.0 lets you 
break up the code gang into 
“units,” or “chunks.” These 
logical modules can be 
worked with swiftly and 
separately—so that an 
error in one module is 
seeable and fixable, and 
you're not sent through all 
your code to find one error. 
Compiling and linking these 
separate units happens in a 


Please check box(es) 


Turbo Pascal 4.0 Compiler $ 
Turbo Pascal Tutor 

Turbo Pascal Database Toolbox 

Turbo Pascal Graphix Toolbox 

Turbo Pascal Editor Toolbox 

Turbo Pascal Numerical Methods Toolbox 
Turbo Pascal Gameworks 


HoOoonuaoo 


Total product amount 
CA and MA residents add sales tax 


4.0’s cursor 
automatically lands 
on any trouble spot 


4.0’s interactive error 


detection and location 
means that the cursor 
automatically lands where 
the error is. While you re 
compiling or running a 
program, you get an error 
message at the top of your 
screen and the cursor flags 


the error’s location for you. 


4.0 gives you an 
integrated program- 
ming environment 


4.0’s integrated environ- 


ment includes pull-down 


menus and a built-in editor. 


Your program output is 


Sugg. Retail 


99.95 
69.95 
99.95 
99.95 
99.95 
99.95 
99.95 


$ 
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In US please add $5 shipping and handling for 


each product ordered 

Outside US please add $10 shipping and 

handling for each product ordered 

Total amount enclosed 
Please specify diskette size: 
Payment: 
Credit card expiration date: ____/ 


Card # 
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automatically saved and 
shown in the output 
window. You can Scroll, 
Pan, or Page through all 
your output and know 
where everything is all the 
time. Given 4.0’s integra- 
tion, you can edit, compile, 
find and correct errors—all 
from inside the integrated 
development environment. 


You'll never lose your 
mind, because 4.0 
never loses your place 


Whenever you re-load 4.0, 
it remembers what you and 
it were doing before you 
left. It puts you right back 
in the editor with the same 
file and in the same place 
as you were working last. 


*Run on an 8 MHz IBM AT. 

**If within 60 days of purchase this product does not perform in 
accordance with our claims, call our customer service department, 
and we will arrange a refund. 


All Borland products are trademarks or registered trademarks of 
Borland International, Inc. Other brand and product names are 

trademarks or registered trademarks of their respective holders. 
Copyright © 1987 Borland International, Inc. 
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The fast lane is fas 


ur new Turbo 

Pascal® 4.0 is so 

fast, it’s almost 
reckless. How fast? 
Better than 27,000 lines 
of code per minute. That's 
much faster than 3.0 or 
any other Pascal compiler 
and the reason why you 
need 4.0 today. 


Pascal. The fastest 
and the best. 


If you're just now 
learning a computer lan- 
guage, learn Pascal. If 
you re already program- 
ming in Pascal, you re 
programming with a 
winner because Pascal is 
the worldwide language 
of choice. Pascal is the 
most popular language 
in university computer 
science classes and with 
computer enthusiasts 
who appreciate Pascal's 
modern SRaEORONE 





YES 


Pascal 4.0 Upgrade Dept. 
Borland International 
4585 Scotts Valley Drive 
Scotts Valley, CA 95066 


structure. It’s powerful, 
coherent, easy to learn 
and use—and with Turbo 
Pascal 4.0—faster than 
ever before. 


Turbo Pascal: 
Technical excellence 


Commitment to tech- 
nical excellence and 


COMPILE 
J 


FASTILANE 





superiority also means 
commitment to detail, 
however painstaking, and 


that takes time. 4.0’s pre- 
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Zip 


This offer is limited to one upgrade per valid registered product. It is good until June 30, 1988. Not good with any other offer from Borland. 
Outside U.S. make payments by bank draft payable in U.S. dollars drawn on a U.S. bank. CODs and purchase orders will not be accepted by Borland. 


decessor, Turbo Pascal 
3.0 is the worldwide 
standard, and with Turbo 
Pascal 4.0, we've bet- 
tered that standard. 4.0 is 
clearly the world’s fastest 
development tool for the 
IBM® PS/2 series, PC’s 
and compatibles—and the 
world’s favorite Pascal 
compiler. 


4.0 breaks the 
code barrier 

No more swapping 
code in and out to beat 
the 64K code barrier. 
Designed for large pro- 
crams, Turbo Pascal 4.0 
lets you use all 640K 
memory in your compu- 
ter. You paid for all that 
memory, now you can 
use it freely. 


For the IBM PS/2 and the IBM and 


Compaq families of personal computers 
and all 100% compatibles. 


'. I want to upgrade to Turbo Pascal 4.0 
@ and the 4.0 Toolboxes 


Registered owners have been notified by mail. If you are a registered Turbo Pascal user and 
have not been notified of Version 4.0 by mail, please call us at (800) 543-7543. To upgrade if 
you have not registered your product, just send the original registration form from your manual 
and payment with this completed coupon to: 


State 


Telephone ( ) 
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s record used by Intr ana MsDos |} 


; = record 
case Integer of 
0: (AX, BX, CX.DX, BP, SI,DI.,DS,. ES, Fiags: 


1: (AL; AH, BL, BH, CL,CH,DL,DH: Byte) >; 





end; 


e and untyped-file record } 


record 
Handle: Word; 
Mode: Word; 
RecSize: Word; 
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— Program in the 
fast lane with 
~~. Borland’s new 
Turbo Pascal 4.0. 





Nows the time 
for a fast decision: 
Upgrade now to 40! 


Compatibility with = Interactive error 


Turbo Pascal 3.0 detection/location 
We've created 4.0 to = Includes acommand line 


be highly compatible with version of the compiler 


version 3.0 and included a 4.0 also 
conversion program and = Saves output screen in a 
compatibility units to help window 
you convert all your 3.0 ” hae a and 50 
programs to 4.0. = Generates MAP files for 
; ; debugging 
eenents of = Has graph units including 
Borland’s new CGA, EGA, VGA, MCGA, 
Turbo Pascal 4.0 3270 PC, AT & T 6300 & 
Hercules support 
. Compiles 27,000 lines = Supports extended data 
per minute types (including word, lon 
= Supports >64K programs integers 
= Uses units for separate = Does smart linking 
compilation = Comes with a free revised 
« Integrated development MicroCalc spreadsheet 


source code 
4.0 is all yours for only $99.95 


Sieve (25 iterations) 
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environment 
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9.3 seconds 


9.7 seconds 
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Sieve of Eratosthenes, run on an 8MHz IBM AT 


Since the source file above is too small to indicate a difference in compilation speed we compiled our GOMOKU program from Turbo Gameworks to give 
you a true sense of how much faster 4.0 really is! 


Compilation of GO.PAS (1006 lines) 
( Turbo Pascal 3.0 


3.6 seconds 
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For the dealer nearest 
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»: Blaise puts the 
Accent on C with 


TOOLS PLUS/S.0 


Enhance your Microsoft C programming environment with 
C TOOLS PLUS/5.0™—a new, quintessential library of C 
ions. C TOOLS PLUS/5.0 from Blaise Computing Inc. puts a prime 
quickly building professional applications using the full power of 
C Version 5.0 and QuickC. Now you can concentrate on program 
/ by having full control over DOS, menus, interrupt service routines, 
resident programs, printer and keyboard control, and more! 


C TOOLS PLUS/5.0 prebuilt libraries are ready to use 
with either QuickC or the Microsoft C Version 5.0 com- 
mand line environment. Complete documented source 
F code is included so that you can study and adapt it to your 
me © specific needs. Blaise Computing’s attention to detail, like 
the use of full function prototyping, cleanly organized 
header files, and a comprehensive, fully-indexed manual, 
makes C TOOLS PLUS/5.0 the choice for experienced 
developers as well as newcomers to C. 


Continuous refinement of Blaise Computing’s library 
products has produced a collection of tools that are 
unsurpassed for reliability, functionality and ease of use. 
Built upon the widely acclaimed C TOOLS PLUS, 
C TOOLS PLUS/5.0 includes such highly-developed 


eatures as: 


























INTERVENTION CODE. 
le. — Schedule C functions at specified times, inter- 


rs, cursor memory. vals or with a “hot key” NEW! 

r input, formatted output. — Take full advantage of DOS, even from memory 
—“printf” window-oriented output. NEW! resident programs. NEW! 

INTERRUPT SERVICE ROUTINES ®FAST DIRECT VIDEO ACCESS 

— Capture DOS critical errors and keystrokes. — All monitors, even EGA 43-line mode. 

— Install hardware interrupt handlers. ®PRINTER CONTROL 


®©RESIDENT SOFTWARE SUPPORT — Access BIOS print functions. NEW! 
— Install, detect and remove memory resident — Control the DOS PRINT utility. NEW! 













programs. ®UTILITIES AND MACROS 
®MENUS — Take advantage of DOS file structure. 
— Horizontal and pulldown. — Manipulate data types, far & near pointers. NEW! 
NEW! — Access any memory areas with fast “peek” and 


— Lotus-style support. NEW! “poke” macros. NEW! 


- C TOOLS PLUS/5.0 supports the Microsoft C Version 5.0 and QuickC 
compilers, requires DOS 2.00 or later and is just $129.00. 


"C ASYNCH MANAGER" Version 2.0 IMPROVED! 
C ASYNCH MANAGER is a library of functions designed to help you 
incorporate asynchronous communication capabilities into your 
application programs. Version 2.0 has been rewritten especially for 
Microsoft C Version 5.0 and Borland’s Turbo C. Simultaneous 
buffered input and output to both COM ports at speeds up to 
9600 baud, XON/XOFF protocol, modem con- 
trol and XMODEM file transfer are among J Jee" 
the many features supported and is priced at y Yes! Sene 


ease S 
1 CA 


_ Windows; ISRs; intervention code; sc 
~ handling and EGA 43-line text mode suppo 











































_ ASYNCH MANAGER ~~ $175.00. 


«EXEC 


ferent languages; specify common data are: 


Text formatter for all programmers; flexible _ 
_ generation; general macro facility. Crafted 


“LIGHT TOOLS $999. 


just $175.00. : Enclosed a 4m 


Blaise computing Inc. hasafullline ofsupport 4 0 gidents 4 
products for both Pascal and C. Call today for your 4 CSS shipping 
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BLAISE COMPUTING INC. b vis of MC: 
2560 Ninth Street, = 316 Berkeley, CA 94710 (415) 540-5441 L yaaa ee 








direct screen access; DOS file handling a 
mofe.ForTurboC. =. “oe 
Turbo POWER SCREEN = >: 
COMING SOON! General screen man: 
ment: paint screens; block mode data en’ 
or field-by-field control with instant scr 
access. For Turbo Pascal. a 


Screen and window management includin 
EGA support: DOS memory control; IS! 
scheduled intervention code; and much n 
Now supports Turbo Pascal 4.0! 


Turbo ASYNCH PLUS $129.0 
Interrupt driven support for the COM port 
I/O buffers up to 64K: XON/XOFF; up t 
9600 baud; modem and XMODEM contro 
Now supports Turbo Pascal 4.0! : 
PASCAL TOOLS/TOOLS 2 $ 
Expanded string and screen handling; gra 
ics routines; memory management; gent 
program control; DOS file support and m« 
For MS-Pascal. a 








Full featured interrupt driven support for th 
COM ports. I/O buffers up to 64K; XON 
XOFF; up to 9600 baud; modem control and" 
X MODEM. For MS-Pascal. pe 


“Super-batch” program. Create batch file 
which can invoke programs and provide 
input to them; run any program unattended; _ 
create demonstration programs; analyze key- 
board usage. A ee 
$9 


- NEW VERSION! Program chaining exec 
tive. Chain one program from another ind 


less than 2K of overhead. 2 





Windows: ISRs: EGA 43-line text mod 
direct screen access; DOS file handling and ~ 
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About the Cover 
The Motorola 68030. Two goo- 
golplex of transistors, count 
them. Is it the Next Big Thing? 


Next Issue 

We don't normally comment 
on unreleased products, but 
since you are the soul of dis- 
cretion, we'll tell you this 
much: the February release 
(Version 13.2) is now in alpha 
and will feature tools for 
debugging. Your SDK _ should 
arrive in 30 days and will 
include reviews of debugging 
tools and articles on debugging 
and a new section of short 
reviews called The Examining 
Room. The user interface will 
show minor bug fixes, and the 
delivery medium will again be 
high-bandwidth paper. And of 
course it’s all upwardly com- 
patible with the preceding 135 
releases. 
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Take a look at the specs on VISTA™, a good look. 
Notice the processing, programming, and video 
capabilities? Now think real hard about what you could 
do with the power of VISTA and a microcomputer. Incor- 
porate it with your system to create a digital pre-press 
proofing station for publishing. Design a graphics work- 
station which outputs both colorful hi-resolution slides 
and broadcast-quality animated images. Construct a 
CAD system which merges computer generated images 
with real-life backdrops for architecture, packaging or 
other industries. And, after you’ve brainstormed your 
way to new horizons of videographics possibilities, get 
your own VISTA and start working. 












Let’s Get Specific. 


We knew you couldn't resist seeing the 
facts, and frankly, our engineers 
wouldn't have it any other way. Here is 
an overview of VISTAS key features. 


FEATURES: 


« 4Mbytes of Video RAM on-board 

¢ Texas Instruments’ TMS 34010 GSP 

« Flexible, programmable resolutions 

¢« NTSC and PAL compatible 

¢ Four 8-bit channels for real-time 
capture 

¢ Fully integrated genlock 

« Processor memory expandable in 
2Mbyte increments to 12Mbytes 

¢ Four 2K x 8-bit CMOS static RAM 
LUTs 

¢ Display can be color-mapped, RGB, 
or a versatile combination of both 

¢ Interlaced and non-interlaced display 

¢ Binary and fractional programmable 
zoom capability, creates horizontal 
and vertical magnify or minify 

¢ Smooth horizontal and vertical pro- 
grammable panning, includes wrap- 
around and split screen 

¢ Suggested Retail Price: $5995. 
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Introducing VISTA" Videographics. 


ADDRESSABLE RESOLUTIONS: 


32 bits/pixel 16 bits/pixel 8 bits/pixel 
1024x1024 2048x1024 4096x1024 
512x2048 1024x2048 2048x2048 
256x4096 512x4096 1024x4096 
CAPTURE RESOLUTIONS:* 
NTSC PAL 
(RS-170A) . (CCIR-624) 
756x486 738x576 
604x486 590x576 
504x486 492x576 
432x486 422x576 


“Resolutions are programmable; these are nominal ones 
for interlaced NTSC and PAL compatible. 


DISPLAY RESOLUTIONS:* 


Non- 

NTSC PAL Interlaced Interlaced 
(RS-170A) (CCIR-624) 

1512x486 1476x576 1024x768 768x576 

1008x486 984x576 (60 Hz) (50 Hz) 
756x486 738x576 

604x486 590x576 768x768 756x486 

504x486 492x576 (80 Hz) (60 Hz) 


*Resolutions are programmable; these are nominal ones. 


COMPUTER REQUIREMENTS: 


Host Type: IBM PC AT and 100% Compati- 
bles, Compaq 386, 
Apollo DN 3000-single-siot board 
Data Bus: 16-bit or 8-bit (self-configuring) 
Bus Clock: 6MHz to 12MHz 
Power 


Consumption: 15 Watts 





CIRCLE NO. 103 ON READER SERVICE CARD 


IBM is a registered trademark of International Business Machines Corp. International Inquiries: contact Techexport at 617/890-6507 (USA), or London at 44-1-991-0121. 
In Italy, contact S/R/O informatica at 39-2-301-0051. Suggested retail price is US domestic price. - 
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It’s So Flexible, 
We’ve Added Support. 


With its Texas Instruments TMS 34010 
graphics processor, large quantity of 
video memory, and proprietary video 
cross-point, VISTA can be programmed 
for an array of powerful market-specific 
videographic applications. To help you 
maximize VISTA’ potential, Truevision 
offers a range of C-language program- 
ming tools for developers. And when 
your system is market-ready, we'll sup- 
port your marketing efforts with our 
TRUEVISION SOFTWARE CATALOG, 
TRUEVISION NEWS, and THE PULSE. 


We’re For Higher 


Resolution...Power...Flexibility... 
Quality. Join the many key manufac- 
turers and developers already working 
with the state of the videographics art, 
VISTA. Call us at 800/858-TRUE for 
more information on the VISTA 
Developer's Program. We're ready to 
take your application today. 


AT&T 

Electronic Photography and Imaging 
Center : 

7351 Shadeland Station, Suite 100 
Indianapolis, IN 46256 

800/858-T RUE © 
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EDITORIAL 


Bx in the late 1970s my best 
friend Renée gave me a pocket 
calculator for my birthday. Needless 
to say, I was impressed. I was sure 
this modern gadget would make life 
a lot easier. It was a great little 
machine: ran on a 9-volt battery, 
had happy red lighted numbers, and 
had lots of blue buttons with seri- 
ous mathematical symbols on them. 

Of course, I err in speaking of this 
machine in the past tense; it still 
lives in my desk at home. I can't 
bear to throw it away. A few weeks 
ago my handy little calculator was 
the butt of several jokes from the 
very modern DDJ editors, and this 
caused me to pause and reflect a bit 
as we face a new year full of exciting 
technological advancements. 

Motorola had a big shindig here 
in October to announce its new 
68030 chip and gave out solar-pow- 
ered calculators as a promotional 
prize. The guys on the staff gener- 
ously donated the calculator to me 
so I could finally enter the 1980s. I 
appreciate this snazzy new tool, but 
somehow I can't bear to part with 
my old clunker. 

January 1988. We've reached an- 
other year closer to 2000, and I find 
I have a hard time letting some of 
what made 1987 possible go without 
mention. Thanks to those great folks 
on the DDJ editorial staff who have 
gone on to bigger and better (?) 
things: Nick Turner, Deborah Hart, 
Vince Leone, and Levi Thomas. Also 
our columnists, who we hope will 
still send in an occasional piece of 
brilliant prose: Michael Ham, Ray 
Duncan, and Namir Shammas. 
(Namir is passing the baton of his 
Structured Programming column 
into the able hands of Kent Porter 
as of next issue.) 

We have lots of exciting things in 
store for 1988, the first being the 
issue you hold in your hands, our 
annual 680x0 issue. In this issue we 
debut our new Macintosh column, 
To the Macs, by Stan Krute. Our 





editorial schedule for the rest of the 
year is as follows: 


February—Debugging 
March—Object-oriented program- 
ming 

April—AI languages 
May—Designing applications 
June—Real-time programming 
July—Distributed data (hypermedia) 
August—Annual C issue 
September—Software engineering 
October—PostScript; Forth 
November—Graphics and video 
December—Operating systems 


Give Tyler a call with any article 
ideas. 

Starting in February, we will add 
Examining Room, a series of short 
product reviews, to DDJ’s traditional 
fare. We won't accept unsolicited 
reviews but invite you to join the 
team of “examiners.” If you have any 
ideas, give Ron Copeland a call. 

So now we're ready for a new 

year. | have my new calculator and 
you have your new magazine. But, 
being a sentimental sort, I’m deter- 
mined to hang on to my relic of a 
calculator. I picture myself well into 
the 21st century, cuddled around 
the heat projection unit with my 
rosy-faced grandkids, all of them 
eager to hear another tale of days 
gone by. ‘Tell us about your first 
calculator again, Grandma,” they will 
say. “Well,” I'll reply, “Back in the 
late 1970s your Auntie Renee gave 
me a pocket calculator for my birth- 
Gay... 
As we dive headfirst into a year 
filled with technological promises, 
let us not forget the people and 
forces that brought us to where we 
are today. Best wishes for 1988. 


Sora Mirah Ruclelag 


Sara Noah Ruddy 
assistant editor 
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Aztec C . 


From real time embedded 
applications to comprehensive 
commercial applications on 
Macintosh, IBM PC, Amiga, 
Atari, and others, Aztec C has 
earned a well-deserved reputa- 
tion as an innovative, tough to 
beat, rock-solid C development 
system. 


But don’t just take our word for 
it—try it yourself. We know that 
the best way to understand what 
puts you ahead with Aztec C is 
to use it. That's why Aztec C 





Targets: 

@ 6502 family 

®@ 8080-8085-Z80-Z180-64180 

© 8088-8086-80186-80286/8087-80287 
© 68000-68010-68020/68881 


Components: 

e C compiler for host and target 
e Assembler for host and target 
@ linker and librarian 

@ Unix utilities make, diff, grep 
@ Unix vi editor 

® debugger 

@ download support 


MS-DOS Hosted ROM Development Systems 
Host + Target: $750 Additional Targets: $500 


systems purchased directly from 
Manx come with a 30-day, no 
questions asked, satisfaction 
guarantee. Call for yours today. 


We can also send you informa- 
tion that details the special fea- 
tures and options of Aztec C. 
Plus information on support soft- 
ware, extended technical sup- 
port options, and all of the 
services and specialized sup- 
port that you may need when 
you re pushing your software to 
the limits and... beyond. 






Features: 

e Complete development system 

e Fast development times 

© Prototype and debug non-specific 
code under MS-DOS 

© Compilers produce modifiable 
assembler output, support inline 
assembly, and will link with assembly 
modules 

© Support for INTEL hex, S record, and 
other formats 

© source for UNIX run time library 

® processor dependent features 

® source for startup 






















Aztec C Micro Systems 


Aztec C is available for most micro- 
computers in three configurations: 
The Professional; The Developer; and 
The Commercial system. All systems 
are upgradable. 


Aztec C68k/Am .... Amiga 
source debugger—optional 


Aztec C68k/Mac ... Macintosh 
MPW and MAC |! support 


Aztec C86 MS-DOS 
source debugger « CP/M libraries 


The followng have special pricing and 
configurations. Call for details. 


Aztec C68k/At..... Atari ST 

Aztec C80......... CP/M-80 

Aztec C65......... Apple ll & I|GS 
Standard System ............... $199 
© C compiler 

e Macro Assemble 

® overlay linker with librarian 

® debugger 

@ UNIX and other libraries 

@ utilities 

Developer System .............. $299 
@ all Standard System features 

@ UNIX utilities make, diff, grep 

@ UNIX vi editor 

Commercial System ............ $499 


@ all Developer features 
® source for run time libraries 
@ one year of updates 


Aztec C is available on a thirty-day money back guarantee. Call 
now and find out why over 50,000 users give Aztec C one of the 
highest user-satisfaction ratings in the industry. 


Call 1-800-221-0440 


In NJ or outside the USA, 
call 201-542-2121 
Telex: 4995812 Fax 201-542-8386 


| wa A 


ww 





C.0.D., VISA, MasterCard, American Ex- 
press, wire (domestic and international), and 
terms are available. One and two day deliv- 
ery available for all domestic and most 
international destinations. 


Manx Software Systems 
One Industrial Way 
Eatontown, NJ 07724 


CIRCLE NO. 104 ON READER SERVICE CARD 





FORUM 


RUNNING LIGHT 


yler surfaced from writing this 

month’s lead article just long 
enough to ask me to step onto this 
page and tell you what to expect 
from the arrival of HyperCard. Here 
goes: 

1. Expect to see explosive growth 
in the number of “light” program- 
mers in the Macintosh environment 
as a result of HyperCard, well 
beyond the effect of Turbo Pascal 
when it burst upon the PC environ- 
ment. There are several facts that 
support this claim: 

It's bundled. A million people will 
have HyperCard by the end of this 
year. Nearly all will actually use it 
(as an application). 

The path from using HyperCard 
to writing your own programs in 
HyperTalk is smooth. The stages, 
from browsing to cut-and-paste ap- 
plication building to modifying exist- 
ing scripts to writing short scripts 
of your own to developing full stack- 
ware applications with HyperTalk, 
may be the easiest gradient up to 
programming ever. 

The pressure for a truly easy Mac 
development tool has been building 
for four years, and the floodgates are 
now open. 

2. Expect prolific output from 
these “light” programmers. Again, 
there are several reasons to believe 
this: 

Ease of programming. Even 
though it embodies principles unfa- 
miliar to a BASIC programmer, Hy- 
perTalk is about as easy as BASIC or 
Pascal. 

The power of the language. Hyper- 
Talk objects and messages are gener- 
ally higher-level components than 
BASIC statements, so you can do 
more with fewer of them. 

Expected aids to programming. 
Apple is developing enhancements 
that will make it easier to do more, 
including toolkits for controlling 
serial communications, AppleTalk 
communications, and_ interactive 
video. And there will be more public- 





domain and shareware program- 
ming aids like Andy Hertzfeld’s PICT 
file importer. Commercial products 
will serve as lessons in program- 
ming, since the source is e€x- 
aminable. 

3. Deduce from these expectations 
an overwhelming outpouring of stack- 
ware (as it is called). The evidence is 
already coming in: ten megabytes of 
shareware and public domain stack- 
ware was developed in the first 
three months after the announce- 
ment. 

4. Expect the inevitable result: Hy- 
perGlut. While some amateurs will 
produce software that is far from 
amateurish, we will soon see un- 
precedented amounts of poor work. 
But obviously-bad software is just 
noise in the channel; the real Hyper- 
Glut will be in the stackware prod- 
ucts that meet needs cheaply but 
poorly. That will, sadly, be used. 

5. Expect the end of the predict- 
able Macintosh user interface. That 
only worked while nearly everybody 
conformed nearly all the time. 

6. Expect bad practices and poor 
programming style to become in- 
grained. This is a more depressing 
thought the more you dwell on it, 
because there are more ways to pro- 
gram badly with HyperCard than 
with BASIC. With HyperCard, snip- 
pets of code can reside in various 
places, such as attached to a button 
or to the card on which the button 
resides, and the inheritance struc- 
ture of HyperCard allows events to 
drop through various objects, search- 
ing for a handler. 

The object-oriented equivalent of 
spaghetti: what a concept. 


A Bd Soros 


Michael Swaine 
editor-in-chief 
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Reaffirmation 

“We who have had some degree of 
involvement with DDJ and People’s 
Computer Company (PCC) modestly 
think of this publication as the lever 
which, with the slightest degree of 
pressure, just might move the world a bit. 
By serving the high end of the tech- 
nological spectrum, some of our efforts 
do find their way by mysterious means 
into products and services which help 
people. This happens when one of our 
readers who sees the true potential of 
computers, and some piece of software 
we publish, puts them together in new 
ways.” Editorial, Marlin Ouverson, Editor, 
DDJ, December 1982. 
















































Tales of Future Passed 

“The Xanadu Hypertext System is one 
of the most powerful systems in existence 
for managing text in a micro-to-main- 
frame database environment. It can store 
arbitrary numbers of documents and 
retrieve them on demand. It can organize 
them by using a highly generalized link 
facility and by allowing (and keeping track 
of) multiple users on the same system, 
and allow those users to work with each 
other on a common document base. It 
can grow indefinitely over a large dis- 
tributed network with minimal degra- 
dation in performance... Roger Gregory, 
“Xanadu - Hypertext from the Future,” 
DDJ, January 1983. 
















































Pretty Is As Pretty Does 

“The laws of entropy insure that the 
line numbers of a debugged and opera- 
tional BASIC program give the appearance 
of having been selected by a KENO 
machine. In fact, while several texts detail 
how the boundary conditions of a KENO 
game lead to predictable outcomes, 
finished programs seldom exhibit this 
property. Many a time I have spent an 
extra hour retyping a finished program 
while spacing the line numbers evenly 
just to make it look good.” “Renumbering 
& Appending BASIC Programs on the 
Apple II Computer,” Steve Wozniak, DDJ, 
February 1978. 


























Dr. Doss's OURNALof 


COMPUTER 
CU alisthencs &5 O)rthodontia 


Running Light Without Overbyte 








Dr. Dobb’s Journal, January 1988 


ve! Introducing Turbo C 1o— 
the best optimizing compiler 
sets even better! 


The professional 
optimizing compiler 
for less than $100 

Turbo C® is a techni- 
cally superior produc- 
tion-quality compiler. 
(Borland’s equation sol- 
ver, Kureka™, is written in 
Turbo C.) And our Turbo 
C 1.5 offers a new library 
of the highest presenta- 
tion-quality graphics in 
the industry—the kind 
you ll see in Quattro,” 
our new professional 
spreadsheet. 


Actual photograph of Turbo C graphics displayed on IBM 8514 screen. 





Turbo C 1.5 gets you into great pictures and adds dazzling new features 


And spectacular graph- —* Text/video functions, ¢ Sample graphics 
ics are just part of the including windows applications 
brand-new features. e 43- and 50-line mode ¢ More than 100 new 
Turbo C 1.5 enhance- Support functions 
ments also include: ¢ VGA, CGA, EGA, Hercules, For professional-quality C 
° A professional-quality and IBM 8514 support at an affordable price, no one 
graphics library of over ¢ File search utility (GREP) else comes close to Turbo C. 
70 functions Because no one can deliver 
¢ A librarian that allows you technical superiority like 
to build your own object cS Borland. . 
module libraries =o 60-Day Money-back Guarantee* 
* Context-sensitive help for For the dealer nearest 


the language and the you or to order, call 
library routines BORLAND ( 3800) 543-7543 


Minimum system requirements: For the |BM PS/2™ and the IBM° and Compaq® families of personal computers and all 100% compatibles. PC-DOS (MS-DOS®) 2.0 or later. 384K. 
“Customer satisfaction is our main concern; if within 60 days of purchase this product does not perform in accordance with our claims, call our customer service department, and we will arrange a refund. 
All Borland products are trademarks or registered trademarks of Borland International, inc. Other brand and product names are trademarks or registered trademarks of their respective holders. Copyright ©1987 Borland international, inc. BI 1165 


It's easy to upgrade to Turbo C 1.5! 


Just complete this coupon and mail it with payment before June 30, 1988. Or, call us at (800) 543-7543 and be ready to give our operators your name, 
credit card number, and the serial number on your Turbo C master disk. 











Turbo C 1.5 Upgrade Price $ 33.50 Please specify diskette size O 5%" O 3%" 
CA and MA residents add sales tax Method of Payment: O VISA O MC O Check O Bank Draft 
Shipping and handling Credit card expiration date: / 

In US $5.00 (Outside US add $10) jaaapenenansnciadinaaieaieias 


Total amount enclosed $ 


Must include your Turbo C serial # 


Return this coupon and the Turbo C RTL source code registration form from your Turbo 
C manual along with your payment by March 31, 1988 and receive your Turbo C 1.5 Sip Address 
upgrade for free! (No phone orders please.) 


Turbo C 1.5 Runtime Library | 
Source Code $ 150.00 Zip 


CA & MA residents add sales tax Mail coupon to: Turbo C 1.5 Upgrade Dept., Borland International 
Price includes shipping to all US cities. 4585 Scotts Valley Drive, Scotts Valley, CA 95066 


(Outside US add $10) This offer is limited to one upgrade per valid product serial number. Not good with any other offer from 
Total amount enclosed $ Borland. Outside US make payments by bank draft payable in US dollars drawn on a US bank. 
CODs and purchase orders will not be accepted by Borland. 
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LETTERS 





Optimum Performance? 
Dear DDJ, 

Either Richard Relph’s article on op- 
timizing compilers for C (August 
1987) has a slight error, or I’m going 
to have a lot of trouble with my 
code if I start to use one. I believe 
the example of common subexpres- 
sion elimination he refers to as block 
range optimization is at least 
module range and could be pro- 
gram range. 

Under the K & R definition of C, a 
two-dimensional array is not neces- 
sarily a continuous block of storage. 
An expression such as alij[j] refers 


to the jth element of the block 


pointed to by aliJ. The ele- [7 
ment a is an array of pointers i 
to appropriate objects. This 
permits arrays in which rows | 
can have different sizes and | 
in which rows can be | 
switched by swapping point- 
ers and permits arrays to be 
built up dynamically during 
execution. Consequently, the —_ 
identification of d/iJ[j] with | © 
d/ol[t0) where tO=i*10+ j is | — 
not always correct. : 
Even if we can be assured | 
that the dimensions of d will | — 
be 10X10 when copy() is | 
called, if the storage of d was ¢ 
allocated one row at a time 
(as is often the case in my 
programs), there is no assur- 
ance that d(/ij[j) can be ad- 
dressed as in the example. 
There is even no assurance 
that the address of d/iJ[j) will 
bear the same relationship to 
that of d/0J/0) as s/i[j] will to 
s[0)[0)].In the particular example 


10 






given, that assurance is provided by 
the declarations of d and s. (Even 
that assurance could be compiler 
implementation dependent, though 
I know of no compilers for which it 
would not be correct.) But these 
were globals, declared outside the 
function, so the optimization indi- 
cated requires at least module-level 
information and in other cases 
might require program-level informa- 
tion. 

Any optimizing compiler that 
streamlines multidimensional array 
addressing in this way will either 
have to incorporate information 
beyond the function being optimized 
or it will have to restrict this tech- 
nique to certain arrays declared 
within the function. 

Thanks for an interesting article. 
Keep up the good work. 

Clyde Schechter 

116 Pinehurst Ave., Apt. D-63 

New York, NY 10033 


Better (or Worse) Standard 
Dear DDJ, 

I had mixed emotions after reading 
Richard Relph’s description of the 
forthcoming ANSI C standard in the 
August 1987 issue. As a programmer 


on 


“Good Grief—now They’ve penetrated 
Our networks!” 


working almost exclusively in C, I 
like the idea of replacing local dia- 
lects with a common language, and 
I like many of the proposed en- 
hancements. I am disturbed, how- 
ever, by the move to merge the li- 
brary routines into the definition of 
the language. At present, the C lan- 
guage is unique in not including 
library routines as part of the specifi- 
cation, which I think is the right 
approach. 

For example, the article mentions 
that library function names and 
macros are to be reserved words, to 
eliminate the possibility of program- 
mers substituting their own func- 
tions for standard ones. I have often 
substituted such routines to good 
effect while debugging a program, 
however. Similarly, it can be useful 
to set breakpoints on routines such 
as strcpy(), which will be impossi- 
ble if the compiler is free to substi- 
tute in-line code for my subroutine 
call. 

Although I agree that the library 
functions should be standardized, 
making them part of the syntax itself 
hurts the language. The justification 
for this seems to be that it makes it 
easier to optimize the code, but it is 
a poor trade to take away 
capabilities in order to go 
, easy on the compiler! 

W At present, I know what's 

=“ going on when I call strcpy() 
in any compiler, and if I want 
| to speed up my program, I 
| can write in-line code myself. 

With ANSI C, programmers 
won't know how to write effi- 
_| cient code without knowing 

| which compiler will be used 

4) to compile it. This improves 
. | portability? Perhaps the ANSI 
| committee needed a few 
| more members who buy com- 
pilers along with those who 
write them. 

William F. Linke 

286 Dunhams Corner Rd. 

East Brunswick, NJ 08816 


Richard Relph replies: 

Mr. Linke’s letter makes a key 
observation. The C library is 
now “standardized.” Without 
this change, program portabil- 
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Macic PC: 
A REVOLUTION IN POWER, PRICE 
& PROGRAMMING SPEED 


ou know how database applications are created — by hacking out 
line after line of time-consuming code. Most DBMS’ and 4GL’s give 


you some programming power. But when it comes to serious applica- For a limited time, you can get Magic PC for only $199. And even at this low price, Magic PC 

tions, they keep you bolted to your seat writing mountains ef tedious is risk-free. If you're not completely satisfied, simply return it within 30 days and we'll buy it 

code. And rewriting it all over again with every design change. back (less $19.95 restocking fee). And if you'd like a preview, Magic PC’s Tutorial Demo is 
Imagine how much faster you'd be if you could replace the painful available for just $19.95. 

coding phase with an innovative visual technology which takes only a But you'd better hurry — Magic PC’s special $199 price won’t last long! 


fraction of the time: Introducing Magic PC—the revolutionary Visual 
Database Language from Aker Corporation: 


Customer No: 


With Magic PC’s visual design language you quickly describe your “Sesacemn 


programs in non-procedural Execution Tables. They contain compact 
programming operations which are executed by Magic PC’s runtime s 
engine. You fill-in the tables using a visual interface driven by windows | dBASE MGubES 
and point-and-shoot menus. One table with 50 operations eliminates | 

writing more than 500 traditional lines of code. Yet with Magic PC you 
don’t sacrifice any power or flexibility. 


re ites Type Description Ee Description 


N 


Do a TATE 





Pop-up Zoom Windows run multiple programs per screen — with 
point-and-shoot data transfer between windows! 


To unleash your DBMS design power, order your $199 copy of 
Magic PC right now by calling toll-free or returning the coupon below. 


ORDER NOW: CALL 





In CA (714) 250-1718 


“Magic PC's data base engine delivers powerful applications in a 
fraction of the time. . . there is truly no competitive product.” 
Victor Wright — PC Tech Journal 


Also recommended by: PC Magazine, PC World, PC Week, Computer 
Language, Data Base Advisor, and many other publications worldwide. 


MAGIC PC 


The Database Language 

TAKER 
HAG 
Yes! | want 
to generate powerful 
applications much faster! oT 
C) Rush me my copy of Magic PC at the special promotional price 
of $199 (add $10 P&H, and tax in CA Intemational orders add 
$30). I understand I can return Magic PC for a refund within 30 
days, if I’m not completely satisfied. * 
CL) Rush me a copy of Magic PC Tutorial Demo at $19.95 (add $5 
P&H, and tax in CA International orders add $15). 

Name 
Company 
Street Address (no POB) 


OG eee State Zip 
C Check enclosed Charge to my: vs Oo c= o eed 


With a powerful set of bigh-level non-procedural operations you 
program at only a fraction of the time. 


With Magic PC, you can generate robust DBMS applications includ- 
ing screens, windows, menus, reports, forms, import/export, and much 
more! Plus, Magic PC has one of the friendliest user interfaces you've 
ever seen. Using Magic PC you can look-up and transfer data through 
a powerful Zoom Window system. Magic PC even lets you perform 
command-free queries. 





Magic PC incorporates Btrieve, the high-performance file manager 
from SoftCraft. This gives you exceptional access speed, extended data 
dictionary capabilities, and automatic file recovery! 





With Magic PC you can modify your application design “on the fly’ 
without any manual maintenance. Magic PC automatically updates 
your programs and data files on-line! This also makes Magic PC an 
ideal tool for prototyping complete applications in hours instead of days. 





Magic PC comes complete with LAN features. Develop multi- user 
applications for your LAN with Magic’s file and record- locking 


security levels. 








Distribute your applications and protect your design with Magic PC’s 
low cost runtime engine. 








Best of all, Magic PC is an unbeatable bargain. For a limited Account No. — — — — — — —————____ ate 
time, Magic PC’s price has been reduced to only $199! Yes, this is Acct. Name Exp Date 
the same Magic PC that normally lists for $695! And Magic PC on 








nt Retum to: Aker Corp., 18007 Skypark Cir B2, Irvine, CA 92714 
eliminates the need for a separate DBMS, compiler, or applica- © SPQ <M Ft Retum tox Acer Cor Be ee ee ee ee 


tion generator. It comes complete with all the tools you need 4 ov: System requirements: IBM PC, XT, AT, PS/2 or 100% compatible with 512K RAM, hard disk and DOS 
to develop your database applications instantl f fi 2.0 or later. 5'4” format, not copy protected. Dealer pricing available. * Retum policy valid in US only. 

ee = ee ¥ y a Aker, Magic PC, The Visual Database Language are trademarks of Aker Corporation. All other 
trademarks acknowledged. © Copyright 1987, Aker Corp. 
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(continued from page 10) 





ity is unobtainable. It should be 
noted, however, that library routines 
are not mandated for freestanding 
environments, such as embedded sys- 
tems. 

I have some difficulty with his 
final paragraph. He seems to be want- 
ing both maximal speed and maxi- 
mal portability, a desirable goal, I 
agree. The two are often at odds 
with one another, however. Perhaps 
a solid example would help here. 
Suppose I need to perform a string 
copy operation. I could either call 
strcpy or code it in-line. Mr. Linke's 
assumption is that, by coding it in- 
line, he would get the best perform- 
ance. This is not necessarily true, 
even with today’s non-ANSI compil- 
ers. Most libraries implement strcpy 
in assembly language, using instruc- 
tions that most C compilers cannot 
normally generate, such as REP 
MOVSB in the 8086. Therefore, the 
programmer already doesn't know 
what’s most efficient. Mr. Linke fur- 
ther assumes that he “knows what's 
going on when I call strcpy() in any 
compiler.” Is he aware that some 
existing compilers perform in-line 
expansion of key library functions? 
MetaWare and Microsoft's both do 
this, and I’m sure others will follow. 

By reserving the library function 
names for the compiler, the com- 
piler can do several things that 


254 10 

234 12 * 10 
254 36 * 10 
10.4 

1000 1 


UNITS INCHES 
UNITS FEET 

UNITS YARDS | 
UNITS CENTIMETERS 
UNITS METERS 


\ Usage: 
10 FEET “ 
. <cr> 


<cr> 3048 ok 
3000 ok 


Example 1: Conversion program 
using the defining word UNITS 





VARIABLE 
: AS -1 SAS> | ; 


<AS> 


: UNITS CREATE SWAP , , DOES> © 


IF SWAP THEN 
BEHEAD' <AS> 


\ UNIT DEFINITIONS REMAIN 


\ Usage: 
10 Beer . 


3048 AS FPEET .. <er> 








<cr> S048 ok 
10 ok 


would otherwise be impossible. 
First, the library itself can call library 
routines. If users were allowed to 
replace strcpy, for example, other 
library routines such as printf could 
not call it. This essentially means 
that for the normal case when pro- 
grammers do not replace strcpy, but 
do call it, the library must include 
two copies, one with some strange 
name for the library itself and one 
for the user to call. 

Second, the library can be granu- 
larized at other than the function 
level. Although it is nice to have a 
library that is function granular, 
some machines cannot support li- 
braries with so many “chunks.” If 
the implementor thought that strcpy 
and memcpy made a reasonable pair 
and put them in a single module, 
and the programmer replaced strcpy 
but called memcpy, what could the 
linker do? 

Last, the compiler can now re- 
place some calls to functions with 
in-line assembly-language code, 
taking into account the actual pa- 
rameters. This is optimal efficiency, 
allowing the insertion of the assem- 
bly-language version of strcpy in the 
code, saving the call and return over- 
head. 

At the risk of being taken literally 
and in the extreme, let me say that 
leaving operations at as high a level 
as possible is always desirable. If I 
can call strepy, or write it in-line, I 
will pick the call—for efficiency, for 
maintenance, for clarity, and for stan- 
dardization. 

Finally, let me say that these com- 
piler features are what people will 
probably start basing their buying 
decisions on. This is a net plus. 
People who want what Mr. Linke 
wants will probably be able to get it 
and people who don't will be able 


0 <AS> | 


<AS> @ 
*/ © <ASS + = 


\ TO MAKE IT LOCAL FOR SECURITY 


THE SAME. 


Example 2: Code to convert back to input units when outputting 


a a a nk a a ar arr 


12 








to get something else. 


Dimensional Data 
Types in Forth 

Dear DDJ, 

This letter is an addendum to Eric 
Lundquist’s comment _ (Letters, 
August 1987) on Do-While Jones’ ar- 
ticle “Dimensional Data Types” (in 
Ada). His astonishment at the 
lengthy code required to implement 
this simple idea in Ada is, of course, 
justified. As a theoretical physicist 
and accident consultant who uses 
dimensioned data every day of my 
life, I was equally astounded. 

Experienced Forth programmers, 
on the other hand, must have 
smiled indulgently, murmured 
“What fools these mortals be!’, and 
passed on. As a fairly recent convert 
to Forth (and a heavy user of this 
language for scientific computing), 
however, I cannot pass up this op- 
portunity (we recent converts tend 
to be zealots) to exhibit how easily 
dimensioned data can be imple- 
mented in Forth. Perhaps Mr. Lund- 
quist—who feelingly alludes to the 
advantages of assembly language— 
will then be sufficiently piqued to 
give Forth a try. 

Suppose you need to input dis- 
tances in various units. For example, 
U.S., English, and Continental police 
reporting accidents might wish to 
use inches, feet, and yards, or centi- 
meters and meters. Rather than writ- 
ing different versions of a program, 
and making users worry about 
which one they are using, it is sim- 
pler to write one program and make 
unit conversions part of the gram- 
mar. Thus, for example, you might 
keep all internal lengths in millime- 
ters and convert as follows: 


: INCHES 254 10 */ ; 

: FEET [ 254 12 * ] LITERAL 10 * ; 

- YARDS [ 254 36 * ] LITERAL 10 */ ; 
: CENTIMETERS 10 * ; 

: METERS 1000 * ; 


The usage would be: 
10 FEET . <cr> 3048 ok 
These are more definitions than nec- 


essary, of course. A better alternative 
(continued on page 126) 
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Users and industry press alike have 
unanimously proclaimed BRIEF as 
the best program editor available 
today. Now, the best gets better, 
with the release of BRIEF 2.0. 

Straight from the box, BRIEF offers 
an exceptional range of features. 
Many users find that BRIEF is the 
only editor they'll ever need, with 
features like real, multi-level Undo, 
flexible windowing and unlimited 
file size. But BRIEF has tremendous 
hidden power in its exclusive macro 
language. With it, you can turn BRIEF 


meee 


541 Main Street 

Suite 410D 

So. Weymouth, MA 02190 
(617) 337-6963 













Requires an IBM PC or compatible with 
at least 192K RAM. 


BRIEF is a trademark of UnderWare, Inc. 
Solution Systems is a trademark of Solution Systems. 
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into your own custom editor con- 
taining the commands and features 
you desire. It's fast and easy. 

Jerry Pournelle, columnist for BYTE 
magazine summed it all up by saying 
BRIEF is, “‘Recommended. If you 
need a Benet! purpose PC program- 
ming editor, look no further.’ His 
point of view has been affirmed by 
rave reviews in C JOURNAL, 
COMPUTER LANGUAGE, DR. 
DOBB'S JOURNAL, DATA BASED 
ADVISOR, INFOWORLD AND 
PC MAGAZINE. 
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ND FLEXIBILITY 
BRIEF 2.0 


One user stated ‘‘BRIEF is one of 
the few pieces of software that I 
would dare call a masterpiece.’ 
Order BRIEF now and find out why. 
BRIEF 2.0 is just $195. If you already 
own BRIEE call for upgrade 
information. 

TO ORDER CALL: 1-800-821-2492 
(in MA call 617-337-6963) 
As always, BRIEF comes with a 


30 day money-back satisfaction 
guarantee. 
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The new COMPAQ DESKPRO 386/20” 


The world now has two new 
benchmarks from the leader 
in high-performance personal 
computing. The new 20-MHz 
COMPAO DESKPRO 386/20 and 
the 20-lb., 20-MHz COMPAQ. 
PORTABLE 386 deliver system 
performance that can rival 
minicomputers’. Plus they intro- 
duce advanced capabilities 
without sacrificing compatibil- 
ity with the software and hard- 
ware you already own. 


Both employ an industry- 
standard Intel’ 80386 micropro- 
cessor and sophisticated 32-bit 
architecture. Our newest porta- 
ble is up to 25% faster and our 
desktop is actually up to 50% 
faster than 16-MHz 386 PC's. 
But we did much more than 


simply increase the clock speed. 


For instance, the COMPAO 
DESKPRO 386/20 uses a cache 
memory controller. It comple- 
ments the speed of the micropro- 


cessor, providing an increase in 
system performance up to 25% 
over other 20-MHz 386 PC's. It's 
also the first PC to offer an op- 
tional Weitek™ Coprocessor Board, 
which can give it the performance 
of a dedicated engineering work- 
station at a fraction of the cost. 

They both provide the most 
storage and memory within their 
classes. Up to 300 MB of storage 
in our latest desktop and up to 
100 MB in our new portable. 
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It simply works better. 


most powerful PC's 
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and the new 20-MHz COMPAO PORTABLE 386° 


Both use disk caching to inject 
more speed into disk-intensive 
applications and both will run 
MS’ OS/2. 

As for memory, get up to 16 MB 
of high-speed 32-bit RAM with 
the COMPAO DESKPRO 386/20 
and up to 10 MB with the COMPAO 
PORTABLE 386. Both computers 
feature the COMPAO® Expanded 
Memory Manager, which supports 
the Lotus’/Intel*/Microsoft* Ex- 
panded Memory Specification 


to break the 640-Kbyte barrier 
imposed by DOS. 

With these new computers 
plus the original COMPAQ 
DESKPRO 386™ we now offer 
the broadest line of high- 
performance 386 solutions. 
They all let you run software 
being written to take advantage 
of 386 technology, including 
Microsofts Windows/386 Presen- 
tation Manager. It provides 
multitasking capabilities with 


today’s DOS applications to 
make you considerably more 
productive. But that’s just the 
beginning. For more informa- 
tion, call 1-800-231-0900, 
Operator 43. In Canada, call 
416-733-7876, Operator 43. 


Intel, Lotus, Microsoft, and Weitek are 
trademarks of their respective companies. 
©1987 Compag Computer Corporation. 
All rights reserved. 
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386 vs. 030: 


The Crowded Fast Lane 





Picking the fastest CPU can be difficult when 
not even the benchmarks agree 


by Tyler Sperry 


and rise of Intel’s 80386 microprocessor and its 
related software in some detail. The ability of 386 
machines to maintain compatibility with MS-DOS soft- 
ware while also giving substantially faster performance 
is something we all can respect. The 80386 isn’t the only 
CPU that can lay claim to the title of fastest microproces- 
sor, however. Recently, Motorola introduced the latest 
member of its 68000 line—the 68030—with performance 
claims that would leave the 80386 in the dust. Obviously, 
this claim bears some investigation. 


Pp: issues of DDJ have detailed the introduction 





The 68000 Gets Respectable 

Like many of you, my first experience with a 68000-based 
computer was the original 128K Macintosh. Disillusion- 
ment is the mildest term I'd use for my first encounter. 
Despite the promise of a superfast processor with lots 
of 32-bit general-purpose registers and plenty of memory 
(128K!), I was able to go back to my CP/M machine 
without regret. By burdening the CPU with updating the 
video and emulating a disk controller, the Mac seemed 
a perfect demonstration of Grosch’s Law!; the CPU 
might be inherently faster than 8-bit machines, but 
you'd never be able to prove it by the performance. 

In the last few years we've seen the introduction of a 
number of machines that have delivered on the promise 
of the 68000. The Mac line has matured to produce the 
68020-equipped Macintosh II that rivals the perform- 
ance of the IBM PC AT. At the other end of the spectrum, 
Sun Microsystems has had enormous success with Unix 
boxes based on the 68000 and its descendants. Indeed, 
once you subtract a few proprietary CPUs (from IBM and 
DEC), workstations are powered almost exclusively by 
the 68000. 





When not programming or reviewing hardware and soft- 
ware, Tyler Sperry works at his day job as Editor of DDJ. 
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The Paradox of the Installed Software 

Fine, you say, but what difference does that make when 
there are more than 8 million DOS machines out there? 
And what about the 80386? Doesn't it blow away the 
68020? 

On the first point, I am happy to say that this article 
is concerned with comparing the latest offerings of the 
Intel and Motorola lines, not with software and hard- 
ware marketing. Still, those questions often come up in 
a discussion of the technical merits of competing CPUs. 
(The AMD 29000 looks to be a fantastic chip, but when 
will you get to program one?) For now, let it suffice to 
say that: 


@ Any machine hoping to become the new standard in 
the personal computer marketplace will have to address 
the huge software “inertia” of the millions of DOS 
machines and their software compatibility demands. 

® The high-performance CPUs coming out in the next 
few years will probably make this point moot by provid- 
ing PC emulation at speeds meeting or exceeding an AT. 
(This software already exists for Unix boxes.) 

@ Even if software emulation isn’t suitable, 286 “clone 
cards” are becoming increasingly easier to come by on a 
variety of buses. 


Apples and Oranges 
At first glance, it might seem simple to compare the 
performance of the 80386 and the 68030. Just set up a 
test jig with some memory and the two CPUs and run 
some benchmarks. Although that approach might have 
worked with 8-bit CPUs (the infamous “good old days”), 
there are a few problems when you get to the new 32-bit 
processors. 

There's memory, for example. Do you furnish the 
processors with the fastest static RAM available and let 
them run flat out, or do you run with a “typical” system 
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386 vs. 030 
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(dynamic RAM) and slow the CPUs down with wait 
states? Arguments can be made on either side. 

In the case of the 68030/80386 controversy, this con- 
cern has actually been addressed by the chip manufac- 
turers. Both CPUs have provisions for handling the 
common problems associated with using dynamic RAM 
slower than the CPU can handle. Both chips have a 
provision for “burst mode” access, for example, which 
allows contiguous bytes of memory to be accessed 
without the delays normally associated with address 
setup and decoding. In some respects these two CPUs 
are more similar than different. There is one significant 
difference in their approach to handling memory access, 
however, that has a substantial impact on performance. 


Cache As Cache Can 

Let’s take a brief detour down memory lane (so to 
speak). Back in the days of the 6502 and 8080, access to 
memory was slow but relatively straightforward. If the 
processor wanted an instruction, it went out to the 
memory bus and fetched one. 

This procedure began to change with the introduc- 
tion of the Intel 8088. One of the features of the 8088 was 
a 4-byte prefetch instruction queue that attempted to 
separate memory bus activity from computation time. 
Program instructions were moved from memory into a 
prefetch queue and then acted upon. Although this 
sped things up a bit, it was of limited usefulness. (See 
this month's Letters for more on the subject.) Indeed, 
the less charitable have referred to the prefetch queue 
as the prefetch bottleneck. 

Eager to please, the engineers at Intel improved things 
in subsequent Intel designs: the 80386 has a 16-byte 
prefetch instruction queue. (A simplified schematic is 





Physical 
Address 


ALU, etc. 


~ (16 byte) 


internal Data Bus 


shown in Figure 1a.) 

Motorola's attempts at speeding things up became 
noteworthy with the introduction of the 68020. The 
68020 does not have an instruction queue but rather a 
256-byte instruction cache. Once an instruction is loaded 
into the cache from memory, it need not be reloaded 
unless it’s been replaced by a more frequently used 
instruction. Thus, a small, tight loop can run entirely 
from on-board cache memory and result in much faster 
performance. An instruction queue, on the other hand, 
is by definition limited to operating as an instruction 
pipeline; any branch taken forces the reloading of the 
queue. 

As you might expect, the addition of an instruction 
queue can substantially improve a processor’s perform- 
ance. The amount of improvement will, of course, 
depend on how many tight loops there in your code. 
(Yet another reason to be wary of small benchmarks.) 
Thayne Cooper and some engineers at Sperry ran both 
the 68020 and 80386 through some modified EDN bench- 
marks and published the results in IEEE Micro. While 
a 16-MHz 80386 was able to surpass a 16-MHz 68020 
with a disabled cache, enabling the cache better than 
halved the original 68020 benchmark times. (The cached 
68020 beat the 80386 in all tests except the string search 
benchmark.) 


Lies, Damn Lies, and Benchmarks 
Now, given those benchmarks results, it'd seem pretty 
clear cut. The performance improvement of boosting the 
clock speed to 20 MHz should be pretty much the same 
for either chip. Score them neck and neck—with the 
edge to the 68020—and we're done, right? 

Alas, as my friend Jerry Pournelle would say, it isn't all 
that simple. The benchmarks done by Cooper were 
modified 16-bit EDN benchmarks, performed on special 
hardware. The hardware was designed to keep things as 


Address 
Bus 


Data Address 


Internal 
Data Bus 


Figure 1: Simplified view of the memory interface for the 80386 and 68030. The 80386 (a) has a 16-byte prefetch 
instruction queue. The 68030 (b) features a modified Harvard architecture with separate 256-byte caches for both 


instructions and data. 
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A PASCAL COMPILER 
You can program as much as you want in ISO Standard Pascal, or use the 


powerful extensions we’ve added to this production quality compiler. And 
you get complete integration with C and assembly language as well. 


Working together, the 68K Cross Development Tools deliver both 
optimized performance and improved programmer productivity. 
Best of all, Whitesmiths offers everything you need at a very com- 
petitive price. We’ve been delivering and supporting high quality 
software development tools since 1978, and we're committed to 
continually enhancing our product line. 


If you develop 68000 programs on a DEC VAX, an IBM PC, ora 
UNIX workstation, chances are we can save you time and money. 
For more technical details, call our toll-free number today. We also 
offer attractive packages for OEMs. 








(continued from page 18) 





equal as possible for the various processors (the 32032, 
32100, and the 80286 were also tested). 

Unfortunately, life isn’t always fair: your choice of 
machines will often not include units comparable in all 
aspects except CPU; sometimes the benchmarks used in 
a test don't always bear a strong resemblance to your 
actual application and environment; and the compiler 
used can impact your results tremendously. 

Consider the case of poor Richard Grehan at Byte.2 He 
took several varieties of 386 computers and accelerator 
cards, compiled some benchmarks, and ran them. Then 
he did the same thing for a Mac II and some 68020 
accelerator cards in different environments. If you have 
some experience with benchmarks (or if you read Byte 
regularly), you can anticipate what he found: the 80386 
outperformed the 68020 in the majority of tests. 

How to explain this? Well, there are some things to 
note in the Byte article benchmarks. First of all, these 
tests were performed with the intent to test mathemati- 
cal performance. The only nonmathematical tests were 
the infamous Sieve and a quicksort routine. As the 
commercials say, your actual milage may vary. 

Second, although Grehan tried to use the same com- 
piler vendor for all machines, this wasn't always feasible. 
Some of the compilers used for two of the 68020 ma- 
chines gave substantially better times than the Macin- 
tosh compiler used for the other tests, and in fact these 


Playing by your own rules 


Breaking the rules is a compromise. In software development 
breaking the rules can mean using non-standard “features” of 
a compiler, trying to fit your algorithm into a language that is not "™ 
flexible enough. When you do break the rules, you must spend ™ 
time justifying and documenting the change, and more time 
later correcting problems caused by that compromise. 


We're Oregon Software and we propose an alternative: 
choose the rules you want. With Oregon Software’s C++ 


compiler, you can select Kernighan & Ritchie C, 


ANSI C, or C++. You can use code you have already 
written in software projects that will extend into the 


1990’s and beyond. 


Breaking the rules is cheating — choosing your own 


rules is good planning. 
To learn how to write your own rules, call us at 1-800-874-8501; 


or write Oregon Software, 6915 SW Macadam, Portland OR 97219. 


Professional Products for Software Development 
* Pascal-2 * Cross-Development * Modula-2 * C++ * SourceTools « 











386 vs. 030 times were in the same neighborhood as the best 80386 


time (a 16-MHz Compaq 386 with an 80387 coprocessor, 
in Case you were wondering). 

The lesson here is unfortunately all too clear. The best 
benchmark is your target application, ported to the 
prospective machine. Depending on the optimizations 
offered by the compiler and individual machine peculi- 
arities, you'll find benchmarks vary widely—there are 
too many confounding variables for a categorical state- 
ment that one chip is better than another. Still. . . . 


Going Back to School 

After all that discussion and equivocation on the subject 
of the 68020 vs. the 80386, you’d expect making a clear 
statement on the relative performance of the 68030 
wouldn't be too plausible. After all, as of this writing, 
there aren’t many 68030 machines available to test. (Both 
Apple and NeXT are rumored to be working on 68030 
designs; both refuse to comment on unannounced prod- 
ucts.) In reading through the literature, though, I came 
across some things that can let us make a pretty good 
guess. 

To start with, the 68030 implements a modified Har- 
vard architecture along with expanded caching. A Har- 
vard architecture machine uses separate address and 
data buses for both instructions and data; in the 68030, 
a modified Harvard scheme is employed, in which 
separate buses are used internally and then multiplexed 
for access to the system. Figure 1b, page 18, shows a 
simplified schematic of the 68030’s memory interface. 
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It’s time to put graphics 


into your programming. 
A picture’s worth a thousand words. 


E U RBO : ASCAL So your programming isn’t complete 
until you have graphics. TurbDoHALO 
brings your screen and printer to life 

&oas with subroutines that draw, chart, map, 
and display. All with color, shape, 
clarity, perspective and motion. With 

IVE a TurboHALO, create any picture you 

t can imagine. 
: TurboHALO gives you 





graphics power. 

TurboHALO gives you everything you 
need for Turbo C and Turbo Pascal 
graphics programming. A library of 





over 150 graphics subroutines. Drivers 
/ for over 42 graphics hardware devices 
“Ideal! alae — the job for the IBM PC family and compatibles. 
comparable tO Packages costing 
P $3000 io $4000.” You can create the images you want, 
Jim Bromley Pits ig on the hardware you have! 
Superintendent of ‘T like the speed o : 
Secu Management TurboHALoO...it’s ten times faster Fast, proven and reliable. 
than the rat alae TurboHALO is up to ten times faster 
Deniz Terry : ' ' 
Doctnd Candie than other graphics toolkits. And with 
TurboHALO you get proven, reliable 
“TurboHALO is so fun... 
T use it to design programming tools used by 
programs as a hobby...It’s got professionals for years. 
lots of ability.’ ‘ 
William Porter You’ll like TurboHALO or your 
Control Systems Manager money back! 
TurboHALO is available for only $95. 
“We evaluated all of the graphic You get an unconditional 45-day 
development packages for Turbo money-back guarantee on TurboHALO. 
ne ae = boHALO dad To order, call your dealer or IMSI at 
© dang carat (415) 454-7101 or (800) 222-4723. in 
Largest New England Distributor CA (800) 562-4723; in Washington DC 


(202) 363-9340 or in NC(919) 854-4674, 
pe eee es ag 


YES, I want to see the difference 
TurboHALO makes in my graphics 4 
programming! Rush me the following 
TurboHALO Graphics Toolkit(s) @ $95 
each plus $3 shipping. California 
residents add 6% sales tax. 
QO) TurboHALO for Turbo Pascal 
QO TurboHALoO for Turbo i. 
CCheck enclosed for $ 

(made payable to IMSI) 
Ocharge my credit card 

for$_ MO )6visa OF mastercard 





Card Number Expiration Date 





Name 


Title 


qn eeepc es nemesis 
Company 





rE: 
Street 


City State Zip 





Signature a 





Mail to: 


GRAPHICS 


TurboHALO requires 256K memory (min ); memory resident drivers require 2K (Turbo Pascal only); DOS version 2.0 or higher; Borland language/compiler required. TurboHALO is a trademark of 
Media Cybernetics and IMSI. Turbo C and Turbo Pascal are trademarks of Borland. 
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Notice that there are now two 256-byte caches: one for 
instructions and one for data. Given the radical improve- 
ment a cache made in the 68020’s performance, you can 
see why Motorola is proudly trumpeting the 68030 as 
“twice the microprocessor.” Of course, it didn’t hurt that 
the chip runs at a clock speed of 25 MHz. 


Conclusions 

Given that the 80486 is still quite a ways away, Intel 
would probably like you to believe that a 16-MHz 80386 
is equal to a 20-MHz 68020 and that its 20-MHz 80386 is 
equal (or better) to a 25-MHz 68030. Motorola, as you 
might expect, has a different view: a fast 68020 is a match 
for any 80386 and the 68030 blows away an 80386 at any 
speed. 

Aside from the engineer’s instinctive distrust of (other 
people’s) benchmarks, and despite the vendor charges 
and countercharges concerning the benchmarks, there 
are some Clear lessons: 


@ Other things being equal, an 80386 and a 68020 will 
perform at roughly the same rate: bloody fast. 

®@ A 68030 at 25 MHz will probably be faster than any 
80386 you find. How much faster, though, will depend a 
great deal on your software and compiler. 

@ If your application is primarily number crunching, a 
fast math coprocessor is essential and its presence or 


FOR EMBEDDED SYSTEMS DESIGNS 


The most powerful C cross compiler targeting 
the Motorola 68000 microprocessor family. 








Supports the 68881 floating point coprocessor. 


Available on the IBM PC/AT under MS-DOS and 
DEC VAX under Ultrix and VMS. 
¢ COMPLETE —AIl the tools you need for cross- development. 


e VERSATILE—Solves your cross-development problems with 
features like position-independent code generation and sup- 
port for fragmented address spaces. 


e HIGHLY OPTIMIZING — Achieves industry leading per- 
formance through state of the art optimization techniques. 


e FAST—Compiles, assembles, links and downloads 10-20 
times faster than the competition. 


(415) 339-8200 
Sier: 


6728 Evergreen Avenue @ Oakland, CA 94611 
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absence will probably swamp other aspects. 

@ A weak compiler can mislead you on the performance 
of a given system. Conversely, a highly optimizing com- 
piler can completely destroy the value of a poorly 
constructed benchmark.* 

® Beware of virtual machines. Today’s 5-MHz PC clone 
is faster than a 50-MHz 80486 box that won't be shipping 
for another six months. 


Notes 
1. Ted Nelson, Computer Lib/Dream Machines (Microsoft 
Press, 1987). 
2. T.C. Cooper, W.D. Bell, et al., “A Benchmark Compari- 
son of 32-Bit Microprocessors” IEEE Micro, vol. 6, no. 4 
(August 1986). 
3. Richard Grehan, “The New Generation: A Closer Look”’ 
Byte (September 1987). 

4. Richard Relph, “Optimizing Compilers for C” DDJ, 
vol. 12, no. 8 (August 1987). 
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SOFTWARE DEVELOPMENT TOOLS 
The Phar Lap 80386 Software Development Series: 


386|ASMI/LINK by Phar Lap (MS-DOS®) $495 
Full-featured macro assembler and linker. Includes a de- 
bugger and 32-bit protected mode runtime environment. 






80386 High-C™ by MetaWare (MS-DOS®) $895 








80386 Professional Pascal™ (MS-DOS®) $895 


by MetaWare 










UNIX™ and VAX/VMS® cross tools (call) 
The wait for professional software development tools 
for the 80386 is over! Whether you are upgrading an 
existing IBM PC application to the ’386, moving a 
mainframe application down to a PC, or writing the 
next PC best-seller, the Phar Lap 80386 Software 
Development Series is for you. It is an integrated line 
of products which provides everything you'll need to 
create and run 80386 protected mode applications 
under MS-DOS. 










(617) 661-1510 
Phar Lap Software, Inc. “The 80386 Software Experts” 
Ne ee apes erence yhaee 
60 Aberdeen Ave. Cambridge, MA 02138 
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WINDOWS FOR DATA® 





Uncommon Screens 





sensitive help, and ‘ext displays — all within windows. 

L] Provide a common | ser interface for programs that must 
run on different méchines and operating systems. 

|] Build a better fron’ end for any DBMS that has a C- 
language interface most popular ones do). 





FROM END TO BEGINNING 
Windows for Data begins 
where other screen packages end, 
with special features like nested 
pop-up. forms and menus, field en- 
try from lists of choices, scrollable 
regions for the entry of variable 
numbers of line items, and an ex- 





i a ee 
NO WALLS 


If you've been fr istrated by the limitations of other 
screen utilities, dont be discouraged. You won't run into 
walls with Window; for Data. Our customers repeated- 
ly tell us how they’\e used our system in ways we never 
imagined — but wk ich we anticipated by designing Win- 
dows for Data for i nprecedented adapatability. You will 
be amazed at wha’ you can do with Windows for Data. 





clusive built-in debugging system. . 











YOU ARE ALWAYS IN CHARGE 
Control functions that you write and attach to fields 
and/or keys can read, compare, validate, and change the 
data values in all fields of the form. Upon entry or exit 
from any field, control functions can call up subsidiary 
forms and menus, change the active field, exit or abort 
the form, perform almost any task you can imagine. 


as eS sees ~ 





OUR WINDOWS 
WILL OPEN DOORS 
Our windows will open doors to 
oY _ new markets for your software. 
, i High-performance, source-code- 
_ ' compatible versions of Windows 
| for Data are available for 
4 g PCDOS (OS/2 soon), XENIX, 
~~ UNIX, and VMS. PCDOS 
versions are fully compatible with Microsoft Windows, 
TopView, and DESQview. No royalties. 
You owe it to yourself and your programs to try Win- 
dows for Data. If not satisfied, return for a full refund. 
Call for FREE DEMO. 


Vermont 
Creative 
Software 


21 Elm Ave., Richford, VT 05476 
Telex: 510-601-4160 VCSOFT FAX 802-848-3502 


Tel.: 802-848-7731 ext. 31 


Prices: PCDOS* $395; XENIX, VMS, UNIX Call. 
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A Programmers’ Database 


Macintosh Toolbox 


tor the 





by Abdullah Al-Dhelaan and 


ne challenge to writing ap- 
plication software _ for 
Apple’s Macintosh is the 


complex environment. Programming 
the Mac requires the use of an ex- 
tensive set of ROM routines known 
as the Toolbox. These routines, al- 
though largely responsible for the 
machine's radical ease of use, add 
appreciably to the Mac program- 
mer’s work load. The Toolbox con- 
tains more than 600 routines, and 
many of them are required in writ- 
ing even the smallest application. 
Most programmers find themselves 
continually referencing Apple’s mas- 
sive documentation, Inside Macin- 
tosh, for technical details on the 
numerous procedures, functions, 
and data structures of the Toolbox. 

At first, using Inside Macintosh as 
a handy reference manual might 
seem a minor chore. It has a good 
index and is divided into five logical 
volumes. Unfortunately, information 
retrieval time becomes a dominant 
factor in the development process, 
and it quickly becomes obvious that 
an on-line, electronic means of re- 
trieval is needed. 

Our program, MacMan, is an on- 
line programmers’ database that con- 
tains much of the key information 
found in Inside Macintosh. Program- 
mers can use MacMan to fetch the 
name, parameters, comments, and 
often-needed descriptions of the 
Toolbox routines. This information 
can be accessed from within an 
editor as an aid to documentation 
or can be used simply as a way to 


Abdullah Al-Dhelaan and Ted Lewis 
work in the Computer Science Dept. 
Oregon State University, Corvallis, 
OR. 97331. 


Ted G. Lewis 


Putting Inside 
Macintosh inside 
vour Macs 


acquire a better understanding of 
the inner workings of the Mac. Cur- 
rently, the database contains more 
than 500K of text describing the Tool- 
box routines as well as many other 
useful facts about the Macintosh. 

The design goals for MacMan 
were simple: the program should be 
convenient to use, and it should 
contain useful information. Above all 
else, we knew that it had to be 
convenient to be compelling. Con- 
venient meant both simple and 
fast. We knew that programmers 
wouldn't accept MacMan if they 
had to learn a new language or 
come to grips with a complex data- 
base system. 

We also knew that the informa- 
tion contained had to be accurate 
and useful. We could have written 
the information in a more useful 
form than that of Inside Macintosh, 
and we could have selected informa- 
tion from various other sources. We 
rejected these alternatives, however, 
because we didn’t want to risk intro- 
ducing errors or to accidentally in- 
clude ambiguous passages. 

We therefore elected to copy care- 
fully selected passages directly from 
Inside Macintosh. We worked hard 
to convince Apple Computer to let 
us use the copyrighted contents of 
Inside Macintosh _ specifically 


of fact. 





to | 
avoid errors or misrepresentations | 


‘MacMan is not a generalized pro- 
grammers’ database program. We will- 
ingly sacrificed generality for user | 
convenience. As a result, MacMan is 
both fast and extremely easy to use. 
The description of any Toolbox rou- 
tine can be retrieved from the 500K 
database file and displayed in a 
window—all in less than a second. 


Using MacMan 

There are a two ways to use the 
database: an abbreviated version of 
MacMan can be installed in the 
system file as a desk accessory (DA), 
or a full-fledged application version 


‘of the program can be launched 


from the desktop. 

A DA is a special program that 
can run concurrently in memory 
with another application. Most DDJ 
readers are familiar with the con- 
cept of DAs from TSR (terminate-and- 
stay-resident) programs such as Side- 
Kick, but these products illustrate 
an ad hoc solution to the problem 
of writing a DA. In contrast to the 
PC, the Mac allows DAs to be inte- 
grated into the Macintosh operating 
environment. It’s this integration 
that we'll be emphasizing in this 
article. We'll describe the MacMan 
desk accessory and then show how 
it was implemented using the Macin- 
tosh Toolbox functions. 

Two simple access methods are 
provided through the menu: Find 
by Name and View by Category (see 
Figure 1, page 25). Find by Name, as 
you might expect, retrieves the de- 


_ sired Toolbox routine by its name. If 
you don't know the routine’s name, 


you can select the View by Category 
menu item (see Figure 2, page 25). 


View by Category lets you select one 
of the 28 managers as a category 
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and then browse through it. When 
you browse through a category, the 
Toolbox routine names are displayed 
in alphabetical order—selecting one 
of them results in a full display of 
the routine’s description (see Figure 
3, below). If MacMan is unable to 
find a Toolbox routine, it reports the 
error and asks if it should browse all 
the routines that begin with the 
same letter (see Figure 4, page 26). 

The subject of this article, 
DAMacMan, is a version of the data- 
base that runs as a desk acces- 
sory. Before delving into the 
inner structure of DAMac- 
Man, however, we'll first 
review the structure of the 
typical Macintosh application 
and how it relates to calling 
DAs. 







The Structure of 

Mac Applications 

Every Macintosh application 
consists of at least one event 
loop that determines what op- 
erations the application's 
user is allowed to perform. 
The event loop must handle 
all user interactions such as 
mouse clicks, menu _ selec- 
tions, and icon manipula- 
tions. The existence of an 
event loop makes Macintosh 
applications resemble real- 
time control programs more 
than traditional interactive 
sequential programs. 

Every well-behaved applica- 
tion must include a Toolbox 
call to SystemTask so that pe- 
riodic actions, such as updat- 
ing the system clock, can be 
performed by the Macintosh 
operating system. In Exam- 
ple 1, page 26, we show only 
one SystemTask call for each 
pass through the main event 
loop, but in general Sys- 
temTask should be called at 
least once every 16 clock ticks 
(a tick is defined as a 60th of 
a second). If the application 
is doing a lot of work on each 
pass of the event loop, then 
the SystemTask call should 
be made more often. 

The application calls Get- 
NextEvent each time through 
the event loop in order to 
find out what events have 








« 
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taken place since the previous pass. 
GetNextEvent calls the SvstemEvent 
routine, which simply intercepts the 
stream of events, and if an event 
belongs to the DA, that event is shut- 
tled to the DA rather than to the 
application. 

Suppose the user selects the DA 
menu and presses the mouse 
button; this will cause a mouse- 
down event (mouseDown) to be gen- 
erated by calling the DoMouseDown 
routine. The application program- 
mer must write the DoMouseDown 





MacMan arti 
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R Select any Category Please: 


© All 


© Resource Manager 
© Quick Draw 

© Font Manager 

© ToolBox Event Manager 
CG, Window Manager 
©'Control Manager 
© Menu Manager 

© TextEdit 

© Dialog Manager 

© Desk Manager 

© Scrap Manager 

© ToolBox Utilities 





MacMan Edit 

















@ Byrieatiim Edit 









Figure 1: A Toolbox routine is re- 
trieved by giving either its name or 
its manager category. 


© Macintosh Packages 

© Memory Manager 

© Segment Loader 

© 0.S. Event Manager 

© File Manager 

© Printing Manager 

© Device Manager 

© Disk Driver 

© Sound Driver 

© Serial Drivers 

© AppleTalk Manager 

© Uertical Retrace Manager 
© Operating System Utilities 


{Cancel ] 


Figure 2: The MacMan catagories cover the ROM routines for both the user 
interface Toolbox and operating system. 


ae 


limitRect,slopRect: Rect; axis: INTEGER); 


Called with the mouse button down inside theControl, DragControl pulls [8 
a gray outline of the control around the screen, following the 
movements of the mouse until the button is released. When the mouse fi 
button is released, DragControl calls MoveControl to move the control fz: 
to the location to which it was dragged. 


note) 


Before beginning to follow the mouse, DragControl calls 
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Figure 3: An example of a displayed Toolbox routine 
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Sorry, “setwtitlee" is not found 







Should | Give a list of all that start with "s" 









Figure 4: MacMan reverts to browsing if the named Toolbox routine can’t 
be found. 



















PROCEDURE SimpleEventLoop( Var Event: EventRecord ); 


Var UserAction : Boolean; {Has the user done something??} 
Finished : Boolean; {Exit When User Quits} 
Begin 
Repeat 
SystemTask; {To support periodic events} 


UserAction := GetNextEvent( AllEvents, Event); 


{To invoke SystemEvent } 
If UserAction then {Handle the event...} 
Case Event.what Of 


mouseDown: DoMouseDown (Event, Finished ); 


KeyDown : DoKeyDown (Event, Finished ); 

ActivateEvt : DoActivate (Event, Finished ); 

UpDateEvt : DoUpdate (Event, Finished ); 
End; {Case} 


Until Finished; {terminate the program?} 


End; {SimpleEvent Loop} 











Example 1: A simple event loop 






PROCEDURE DoMouseDown ( Var Event : EventRecord; 


Var Finished: Boolean ); 








Var 
whichWindow : WindowPtr; {Window that mouse was pressed in} 
wherels INTEGER; {Part of screen where mouse 
was pressed} 























Begin {DoMouseDown} 
{Where on the screen was mouse pressed?} 
whereIs := FindWindow ( Event.where, whichWindow); 
Case wherels Of 


InDesk: {In Empty Space...} 
{Do nothing}; 

InMenuBar: {Menu Selection...} 
DoMenuClick; 

InSysWindow: {Aha! In a DA... } 





SystemClick ( Event, whichWindow); 


InContent: {In Application's window...} 
DoContent (whichWindow) ; 


InDrag: {Drag Application's window...} 
DoDrag (whichWindow) ; 
InGrow: {Resize Application's window...} 


DoGrow (whichWindow); 
InGoAway: {Close Application's window...} 
DoGoAway (whichWindow) 
{case} 
{ DoMouseDown } 


End 
End; 








Example 2: The DoMouseDown routine 
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(continued from page 25) 


routine in such a way as to call the 
appropriate DA. The code necessary 
to do this is shown in Example 2, 
below. 

The events that are diverted from 
the application to the DA are chan- 
neled into the DA processing code 
in two ways, as shown in the Do- 
MouseDown procedure. The first 
way is through the SystemClick Tool- 
box routine, as shown in case 
InSysWindow of DoMouseDown, and 
the second way is through a menu 
selection. 

When a _mouse-down event 
occurs in a system window, the ap- 
plication code should call Sys- 
temClick. If the mouse-down event 
is in a DA window, SystemClick 
takes care of processing the event 
instead of the application. This case 
will be discussed later as it is what 
happens when the DA is already on 
the screen. 

The mouse-down event could also 
occur in the DA menu (under the 
apple), which would mean that the 
DA is to be activated (this is called 
opening the DA). This is the case we 
are most interested in for the time 
being. If the user has selected the 
MacMan DA, for instance, then the 
application program must handle 
the opening of the DA from the 
DoMenuClick routine, shown in Ex- 
ample 3, page 30. 

As shown in DoMenuClick, when 
an application calls the MenuSelect 
(or MenuKey) Toolbox routine, a call 
is made to SystemMenu, which 
passes the event to the DA (if the 
event is a mouse-down in the DA 
menu). The DA must then handle 
the event and return a zero to the 


| application. Otherwise, MenuSelect 


returns a long integer containing the 
menu number in its HiWord and 
the item number in its LoWord. In 


_| this case, when the user selects the 


Apple menu, and within this menu, 
the MacMan DA, the DoAppleChoice 
routine (see Example 4, page 30) is 
called to activate the DA. 

This sequence of actions opens 
the DA and prepares it for use along- 
side the currently running applica- 
tion. In summary, the sequence is: 


®A mouse-down event occurs and 
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is handled by the event loop. 

@® The DoMouseDown routine de- 
cides the event is InMenuBar. 

® The DoMenuClick routine decides 
the event is an AppleMenu event. 
@The DoAppleChoice routine de- 
cides the event is a DA selection. 

® The name of the DA (accName) is 
obtained and the DA opened. 


The Structure of a Mac DA 

A DA is a “mini-application” that 
can be run concurrently with a 
Macintosh application. A DA cannot 
exceed 32K of executable machine 
code and data and is installed in the 
start-up disk system file using a 
Macintosh utility program called the 
Font/DA Mover. Once a DA is in- 
stalled, it no longer has a file or an 
icon visible from the desktop. In- 
stead, the user opens a DA by select- 
ing it from the standard Apple 
menu, which by convention is the 
first in the menu bar. 

After a DA has been opened, its 
window, if any, is displayed on the 
desktop and it becomes the active 
window. To close a DA, the user can 
click the DA's close box (in its cwn 
title bar), or another program can 
call the function CloseDeskAcc to 
close it. The DA will then disappear 
and the frontmost window will 
become the active window. 

A desk accessory may have a 
menu of its own, which will be 
added to the menu bar when it is 
active and deleted when it is not. 
The Cut, Copy, and Paste commands 
in a standard Edit menu can be 
used by an active DA. They are very 
useful for copying and pasting be- 
tween the DA and the application 
or another DA. 


Writing a DA 

Writing a DA is a lot more difficult 
than writing a ‘plain vanilla’ appli- 
cation because a DA has no main 
procedure, no main event loop to 
obtain events, and no global vari- 
ables. 

Technically, a DA is known as a 
Macintosh device driver, and each 
DA is required to have three special 
procedures: Open, Close, and Ctl (for 
control). These procedures are 
called directly by the operating 


en eee SN 
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system through a special table called 
the DA Header. 

Each of these procedures requires 
two formal parameters of type 
Device Control Record and Parame- 
ter Block Record. A Device Control 
Record is created when a DA is 
opened and destroyed when it is 


closed. A Parameter Block Record is > 


created by the operating system 
each time any of the three routines 
is called. It is used to inform the DA 
about the purpose of the call. 

The Macintosh operating system 
calls Open whenever a DA is se- 
lected from the Apple menu and 
calls Close whenever the close box 





on the title bar of the DA’s window 
is clicked or CloseDeskAcc is called 
by some other program. Between 
these two calls, the system will call 
Ci, 


What DA Procedures Do 
When the Open procedure is called 
to open the DA, it will: 


1. Create the DA window, if there is 
one 

2. Set the WindowkKind field of the 
window's WindowRecord to the DA’s 
driver reference number. (This field 
is set so the operating system can 
call the correct DA when an event 
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DA’s Device Control Entry Record to 
the window pointer. 

4. Allocate space for global data in 
the field dctlstorage of the Device 
Control Entry Record. 


MAC DATA BASE 
(continued from page 29) 


occurs in a DA window.) 
3. Set the DctlWindow field of the 


PROCEDURE DoMenuClick; { Handle mouse-down event in 


menu bar. } 

Var 
menuChoice : LONGINT; 
theMenu : INTEGER; 
theItem : INTEGER; 


{Menu ID and item number} 
{Menu ID of selected menu} 
{Item number of selected item} 


Begin {DoMenuClick} 


menuChoice := MenuSelect (TheEvent.where) ;> 
if menuChoice <> 0 {Application, or DA?} 
Then begin {Application...} 
theMenu := HiWord(menuChoice) ;{Get menu ID} 
theItem := LoWord(menuChoice);{Get item number} 
Case theMenu Of 
AppleID: {Make selection from Apple menu} 
DoAppleChoice ( GetMenu( AppleID ), thelItem); 
{Make selection from File menu} 
DoFileChoice ( GetMenu( FileID ), theItem); 
{Make selection from Edit menu} 
DoEditChoice ( GetMenu( EditID ), 


FileID: 


EditID: 
theItem) 
{case} 
Lat) 

{DoMenuClick} 





Example 3: The DoMenuClick routine 


PROCEDURE DoAppleChoice (Var AppleMenu: MenuHandle; 


theItem : INTEGER) ; 
Var 
accName 


= Stress: 
accNumber : 


INTEGER; 


{Name of desk accessory} 
{Reference number of desk accessory} 


Begin {DoAppleChoice} 
Case thelItem of 
AboutItem: 
DoAbout; 
otherwise {Must be a DA...} 
Begin 
GetItem (AppleMenu, theltem, 


{Application's About... Item} 


accName) ; 

{Get accessory name} 
accNumber := OpenDeskAcc (accName) {Open desk accessory} 
End {otherwise} 

{case} 


{DoAppleChoice} 





Example 4: The DoAppleChoice routine 


Procedure DoEditChoice (...., theitem : 
{ Handle choice from Edit Menu } 
Begin { DoEditChoice} 

if Not SystemEdit (theItem-1) 
Then 
Case thelItem of 
cutitem : 
copyitem : 
Pasteitem 
{ Case} 


Integer); 


DoCut; 
DoCopy; 
: DoPaste; 


end; 
{DoEditChoice} 


End; 








Example 5: The DoEditChoice routine 
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5. Initialize the global data. 


Close is called to close the DA. It 
first disposes of its window and 
stores nil in the DctlWindow field of 
the Device Control Entry Record, 
then it disposes of any global data it 
might have allocated in the dctlstor- 
age field of the Device Control Entry 
Record. 

Ctl is called to enable the DA to 
handle the action indicated by the 
csCode field of the Parameter Block 
Record. There are nine such actions, 
as shown in Table 1. 


Passing Text 
An application must have the stan- 


A DA program 
consists of at least 
three special 
procedures called 
Open, Close, and Ctl. 


dard Edit menu if it wants to sup- 
port passing text to and from DAs. 
The order of items in this menu is 
important, but the menu can be 
made longer by adding items at the 
end. 

The standard Edit menu contains 
Undo, Cut, Copy, Paste, and Clear. 
When a user chooses one of these 
commands, the application must 
call Toolbox routine SystemEdit 
from within DoEditChoice (see Ex- 
ample 5, page 30). The menu items 
are numbered 0 through 5 inter- 
nally, which is why we subtract 1 
from the item number (theltem—1) 
in the routine shown in Example 5. 
If the active window is a system 
window (that is, a DA window), then 
SystemEdit will return false and the 
application will process the com- 
mand as usual. Otherwise, System- 
Edit will shuttle the event on to the 
DA for command processing and 
return true. 


Resources for DAs 
The code for the DA is not a CODE 
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resource, as it is for applications, 
but is a DRVR because a DA is actu- 
ally a device driver. The Macintosh 


. AccEvent 
. AccRun 

. AccCursor 
. AccMenu 
. AccUndo 

. AccCut 

. AccCopy 

. AccPaste 
. AccClear 


1 
2 
3 
4 
> 
6 
7 
8 
9 


Table 1: DA actions allowed by Ctl 


resource compiler RMaker can be 
used to create a DRVR resource by 
reading the CODE resource created 


An event (update, activate, keyboard, .. .) 
Do a periodic action 

Change cursor shape 

Menu selection 

The Undo editing command 

The Cut editing command 

The Copy editing command 

The Paste editing command 

The Clear editing command 





Speed. 





pointers. 
*Time is negligible. 


Fast Execution Speed. - 


Microsoft® C 4.0 Microsoft C 5.0 
Sieve (25 iterations) | oa 
Loop 11.0 0.0* 
Float 19.9 0.1 
Dhrystone 22.8 19.1 
Pointer 14.2 7.4 


- New optimizations generate the fastest code: 
—Inhine code generation. NEW! 
— Loop optimizations: NEW! 
— Loop invariant expression removal. NEW! 
— Automatic register allocation of variables. NEW! 
— Elimination of common sub expressions. 
— Improved constant folding and value propagation. 
- Fine tune your programs for even greater speed: 
— Coding techniques for writing the fastest possible 
programs are included in the documentation. NEW! 
—Segment Allocation Control: 
—Group functions into the same segment to get faster 
NEAR calls. NEW! 
— Specify which segments receive variables to yield 
faster NEAR references. NEW! 
— Uses register variable declarations. 
— Mix memory models using NEAR, FAR & HUGE 


~ Microsoft C5.0 
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Everybody promises, but nobody delivers a real- 
time, emulator-based C-debug environment like Arium’s 
ECHO. 16-bit, true multitasking and UNIX™ based, 
ECHO gives you more power, speed and menu-driven 
features to handle the 68000 and other Ps better than 


the HP 64000, or anything else. 


Prove it to yourself. Read the screens below. Then ask 
any other development system—standalone or host 
control—to match them. We’ll wait. 

Now you know a few reasons (and there are plenty 
more) why ECHO should be your emulation tool for 


today’s increasingly complicated software debugging. 


Just words, you say, promises like all the rest? 


WENT ; 
aoe e 
rie rita 

= 

History 

ey eet 
Se | 
Bre 
a3 a Eat 
Reset target 
ee eRe 
eo eee 
Siete a 
Stack trace 
Etter ats) 
73 er urls 
Sei trap 

leer gtd 


2; state®l ) from festhoxtixot 
2: newstatel sldstate=4& ) fren statef+hx3? 
lef pecupc4+? ) from nouslaiethx78 

r=ti } from idletBxil 


Code Preview™ lets you see where your code 
is going. You can follow calls and branches 
(to 99 levels) on the screen, to select the 
source line on which to trigger, then set and 
break in one keystroke! The highlighted 
trace display (in source) and stack trace 
window show the path your program took. 


For a demonstration call 


800/862-7486 (CA 714/978-9531) 


UNIX is a registered trademark of AT&T. 


| 


(Rates 


EG ab 


xT OPrMirm cs om ow oe 


le trace | Cross-trigger 
TTT TS ee) 
Meds Bee 3252 B) 
Cit see eee 
ora ee eee 
ee et oe Ot 2 
we ee 
G then (8 without €) 
8 then (B witheut ©) 


ed 


£> then € 
Ree eats net) 


he hh: se end: te 


5 


(A+B) then {£+B) hi. eet 


reo] 

o 

Ue bo ine OT 
. Stet 


Stack-Relative Trigger lets you trigger on 
the addresses and values of stack-relative 
variables—a “must” for effective C-debug 
where the address of an automatic variable 
is different each time the function is called 
and is determined at execution. Here, a read 
of the local variable “nrecur” is included in 
the trigger sequence. 


RACORPORATION 
1931 Wright Circle, Anaheim, CA 92806 


5 
Baan tea oP ge ie! & 


F2? starraulil 


: 
FEE mae 3 
H 


"72 


TimeStamp™ and variable display are two 
further features that are a must for real-time 
C-debug. Note the display of two instances 
of a structure in array “starray.” The contents 
of these structures, as for any C variable, 

can be changed right on the screen. 





MAC DATA BASE 
(continued from page 31) 


by the linker with ID=1 and con- 
verting it to a DRVR resource. This is 
done by including the following 
lines in the resource file prior to 
compiling it with RMaker: 


Type DRVR = PROC 
Deskacc,16 
DeskaccFile 


The name DeskaccFile is the 
linker’s output file for the DA file, 
and Deskacc will be used as the DA 
name to appear under the Apple 
menu once the DA is installed in 
the system file. The resource ID then 
becomes the DA’s driver reference 
number and is used by the operat- 
ing system to implement the DA 
and is also used for owned re- 
sources. 


Owned Resources 

A range of 32 resource IDs has been 
reserved for each DA DRVR resource 
ID, so they are called owned re- 
sources. A special numbering con- 
vention is used to associate owned 
system resources with the resources 
they belong to. For any particular 
DA, this range is computed by 
adding $C000 and 32 times the 
driver reference number—for exam- 
ple, if the driver reference number 
is 16, then the range is —15,872 
through —15,857. : 

When the DA is moved from its 
own file or a system file into a 
system file, all its resources for win- 
dows, menus, and so on must be 
transferred along with the code for 
the DA into the destination system 
file. If the destination system file 
already has a DA with the same 
DRVR resource ID, the Font/DA 
Mover will renumber it and all of its 
owned resources. Part of the 
DAMacMan resource file is shown 
in Listing One, beginning on page 
48. 

In summary, a DA program con- 
sists of at least three special proce- 
dures called Open, Close, and Ctl. 
The DA program may have other 
procedures as well, but it has no 
main body. You might think of the 
DA program as a module consisting 
of its own constants,g types, vari- 
ables (Listing Two, page 48), and 
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procedures (Listing Three, page 50). 
Open is called by OpenDeskAcc 
(from the running application); Close 
is called by Ctl (when the DA termi- 
nates itself) or ExitToShell (when the 
application terminates); and Ctl is 
called each time the application 
calls SystemEvent. 

Listing Three shows these three 
procedures for DAMacMan, but keep 
in mind that these procedures must 
always exist for every DA even if 
they are tailored for some other pur- 
pose. In addition, because DAs are 
limited to 32K in size, the sophistica- 
tion of a DA is restricted to mini- 
ature utility functions such as dis- 


playing the keyboard and so on. Im- 
plementing the MacMan database 
retrieval code was quite a challenge 
because of this limitation. 


The Structure of DAMacMan 
When DAMacMan is opened from 
the Apple menu, it looks in the 
system disk to see if the files it 
requires are present. If a file named 
Manual and another file named 
MMIndex are not _ present, 
DAMacMan will display an error 
dialog. 

DAMacMan’'s related files are 
Manual, text from Inside Macintosh 
(the database); MMIndex, the index 


Speed. 





minute. NEW! 


brace matching. 


Fast Compilation. 
Fast Prototyping. 


Microsoft C Version 5.0 includes QuickC™ which 
lets you edit, compile, debug, and execute in an 
integrated environment. It’s ideal for prototyping. 
-In-memory compilation at 10,000 lines/ 


¢ Built-in editor with parentheses, bracket and 


- Use the integrated debugger to animate through 
your program, add watch variables and set 
dynamic breakpoints. NEW! 

-MAKE file is automatically generated for you. 
Simply indicate the modules you want to use, 
then MAKE recompiles and links only those 
modules that have changed. NEW! 

¢Full C 5.0 compatibility: 

— Completely source and object code compatible. 

— Emits CodeView*-supported executables. 

—Identical compile/link command line switches. 


Microsoft C5.0 
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KESIDENT EXPERT Pop-up Reference Guides... 
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fgets(entry_point_string, 5, response 
fclose(responses): | 
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—_——— RESIDENT EXPERT (tn )——— 
MS-C Version 5.8 
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char *fgets(str,cnt,strean): 
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This function 


the input 8 strean 


commands = freopen("dbugi.tmp”, “r", stdin): 
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reads a string fron 


specified by 


<stream> and stores it in <str>. The 


ESS 


ere 


Use One of Our’ or Build Your Own! 


THE POP-UP REFERENCE 
REVOLUTION BEGINS 


How much development time could you save if 
you never had to open another PC language or 
technical reference manual again? What if you 
could just point at a compiler keyword, assembly 
instruction, or function name on your screen and 
with a keystroke have complete, authoritative 
information about language syntax, operands, 
parameters, examples, and much more? 


INTRODUCING THE RESIDENT 
EXPERT SYSTEM 


A growing library of comprehensive, disk 
resident reference guides about the PC and your 
favorite PC languages. All available instantly 
through our unique memory resident pop-up 
access system. 


VIRTUALLY EVERYTHING YOU 
NEED TO KNOW 


Each of our Compiler Reference Guides 
contains virtually everything you need to know 
to program with your preferred implementation 
of your favorite language. Language syntax, all 
library functions, compiler directives, and error 
codes are thoroughly documented. 


Our PC Programmer’s Reference Guide 
documents every PC (and AT) processor 
instruction and every BIOS and DOS service 
interrupt. - You’ll also find tables of keyboard 
codes, line drawing, ASCII, and IBM character 
sets, and much more. 


THE SPECIALIST’S LIBRARY 


Your compiler is unique. That's why our 
reference guides are specialized...each one 
designed for a particular vendor’s language 
implementation. 


NEW! 


RESIDENT EXPERT Compiler 
Make your own Reference 
Guides 


QUICK DRAW ACCESS SYSTEM 


Point-and-shoot...just place the cursor over any 
term on your screen. Chances are we’ve got it 
fully detailed in one of our data bases. 


Fully cross indexed...if the instruction or library 
function you’re using isn’t quite right, our related 
topics cross index can help you find a better one. 


Multiple volumes on line...you can have one or 
a dozen of our pop-up reference guides on 
line...a complete library available instantly. 


THE INFORMATION YOU 
NEED...WHERE YOU NEED IT 


Our pop-up shell varies its size and shape 
dynamically, only taking as much space on your 
screen as it needs and it mever covers your 
working area. You can see your work and our 
reference data at the same time. 


RESIDENT EXPERT Shell (*) ..... $19.95 
(with PC-DOS/MS-DOS Reference Guide) 


RESIDENT EXPERT Compiler..... $39.95 
(create your own Reference Guides!) 


RESIDENT EXPERT Reference Guides 


Borland Turbo C (v1.0)...........- $19.95 
Borland Turbo Pascal (v4.0)......... 19.95 
Borland Turbo Prolog (v1.1)......... 19.95 
Lis CNS 2) os caine dt, 2s alee 39.95 
Mark Williams Let’s C (v4.0)........ 19.95 
Microsoft:€ (v5:0) 1.04 006 ode. 39.95 
Microsoft Quick C (v1.0)..........-- 19.95 


PC Programmer’s Reference Guide . . . $39.95 


*The RESIDENT EXPERT Shell is required 
to access and display all Reference Guides... 


SantakRita 


For the location of your nearest Santa Rita 
Software dealer, or to order direct, call us at 
1-214-727-9217. We’d like to hear from you. 


Santa Rita Software 
1000 E. 14th Street, Suite 365 
Plano, Texas 75074 


The RESIDENT EXPERT System 





Resident Expert is a trademark of The Santa Rita Company. Borland, Turbo C, Turbo Pascal, and Turbo Prolog are trademarks of 
Borland International Inc. IBM and PC-DOS are trademarks of International Business Machines Corporation. Lattice Cisa 


trademark of Lattice Inc. LetsC is a trademark of Mark Williams Company. Microsoft and MS-DOS are trademarks of Microsoft 
Corporation. 
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MAC DATA BASE 
(continued from page 33) 


into the database; MMSize.int, a tem- 
porary file used to generate a ver- 
sion of DAMacMan; MMConfig, a 
DAMacMan software tool for gen- 
erating versions and MMLock, which 
locks and unlocks files. 

Manual, the database, consists of 
two parts: the MacMan distribution 
text and the MacMan information 
that contains all the procedures and 
functions defined in Inside Macin- 
tosh, organized as follows: 


\ name 
category# 
body 


where name is the name of the pro- 


cedure or function, category is the 


MMLock is a 
MacMan tool whose 
Job is to lock and 
unlock the files 
that are generated 





section of Inside Macintosh in which 
it is defined, and body is the infor- 
mation about the procedure or func- 
tion. 

The index file, MMIndex, contains 
records sorted with respect to name, 
each record having the following 
form: 


Record 
name : String[25]; 
start : longint; 
length : Integer; 
man : Integer; 
end; 


where name is the name of the pro- 
cedure or function, start is the start- 
ing position relative to the begin- 
ning of the manual, length is the 
length of the text that belongs to 
this procedure or function, and man 
is an integer representing the sec- 
tion or manager of Inside Macintosh 
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where this function or procedure is 
defined. 

The MMsSize.int file contains the 
statement: 


Const MaxRec = =; 


The blank will be filled in by the 
MacMan tool MMConfig, prior to 
compiling MacMan. The value of 
MaxRec is equal to the number of 
entries in Manual. The DAMacman 
main program is shown in Example 
6, page 41. 


MacMan Tools 
DAMacMan is configured and main- 


And speed. 






¢ Debug larger programs: 


support. NEW! 


program execution: 


to your hardware: 


program executes. 





For your free C5.0 





Fast Debugging. 


Microsoft C Version 5.0 includes Microsoft CodeView, 
our source-level windowing debugger that lets you debug 
more quickly and thoroughly than ever before. 


— Debug through overlays created by the 
Microsoft overlay linker. NEW! 
— Expanded Memory Specification (EMS) 


¢ Fast debugging through precise control of your 


— Access source level and symbolic debug information 
from your Microsoft C, FORTRAN, and Macro. 
Assembler programs. NEW! 

— View your source code and assembly simultaneously. 

— Watch the value of variables change as you execute. 

—Set conditional breakpoints. 

— Animate or single step through your program. 

* CodeView brings you as close as you’ve ever been 


— Swap between your code and output screens. 
— Watch your registers and flags change as your ~~ 


All benchmarks run on an IBM® Personal System/2™ 


Tce ie _ 
(S800) 426-9400. 


In Washington State and Alaska, (206) 882-8088, In Canada (416) 673-7638, 
Microsoft, the Microsoft logo and CodeView are registered trademarks and QuickC 
is a trademark of Microsoft Corporation. IBM is a registered trademark and _ 


tained through the use of a set of 
tools that must be applied each time 
the database is changed. MMConfig 
is a tool for constructing the index 
file for the database and the Pascal 
compiler include file that contains 
the size of the database. In addition, 
the integrity of the database is main- 
tained by locking the database files 
using the MMLock program, de- 
scribed later. 

MMConfig reads the file Manual 
and writes the ordered file MMIn- 
dex with records of the form: 


Record 
name : String [25]; 


























\ 






-— fe 


Personal System/2 is a trademark of International Business Machines Corporation. _ 
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MAC DATA BASE 
(continued from page 35) 


start : Longint; 

length : Integer; 

man : Integer; 
end; 


MMConfig performs the following 
steps: 


1. It forms a record for each proce- 
dure or function in Manual. 

2. It store a pointer to each of the 
records in an array of pointers. 

3. It sorts the array with respect to 
name. 
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4. It creates the file MMIndex, to be 
read whenever MacMan is started 
up, and writes the sorted records to 
it. 

5. It creates the file MMSize.int, 
which will be included during com- 
pilation of DAMacMan. 

6. It locks the files Manual and 
MMsSize.int so they cannot be 
opened by a user who is not sup- 
posed to have access to these files. 
7. It stamps these files with the ap- 
propriate icons. 


MMConfig is run to create MMIn- 
dex and MMsSize.int after Manual 
has been edited the first time and 





whenever Manual is updated. 

Finally, MMLock is a MacMan tool 
whose job is to lock and unlock the 
files that are generated by MMCon- 
fig. 


Data Structures 

As mentioned, after Manual has 
been constructed by entering all de- 
sired text into the database, MMCon- 
fig is run to generate the files MMIn- 
dex and MMsSize.int. Then 
DAMacMan can be compiled and 
run. When DAMacMan is run, it 
loads the file MMIndex into a list of 
type table: 


table : array [1. .MaxRec] of ptr1; 


where ptr1 is a pointer to a record 
similar to those stored in MMIndex 
and MaxRec is the number of func- 
tions or procedures in Manual. 
MaxRec is set by including the file 
MMsSize.int. 


Installing DAMacMan 
DAMacMan is compiled into the re- 
source file MacManFile. The Font/ 
DA Mover utility tool is used to copy 
this file into a system file. After the 
DA has been installed in the system 
file of the start-up volume, it can be 
selected from the Apple menu. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb’s Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
MACINTOSH, KAYPRO). 

The complete source code and 
binary files for DAMacMan are also 
available on Macintosh disk (single- 
sided) from the authors. 
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Only one 
company has 
the technology 


the resources, 
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to top the 
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Introducing the 68030. 


The next generation. 

In 1984, we introduced the 68020. Now, three 
years later, it has the largest installed and 
broadest application base of any 32-bit MPU 
on the market. Having set that standard in 
the first place, we feel qualified to raise it. 
Which is why the only microprocessor that 
really surpasses the 68020 is our 
second Scan gs 
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MS-DOS is a trademark of Microsoft Corporation. UNIX is a 
registered trademark of AT&T. ©1987 Motorola, Inc. 






Anarchitecture you can build on. 
And count on. 


Application software that runs on any 
68000 family MPU runs on the 68030. There’s 


also a full array of development tools, and a 


new 68882 floating point co-processor, with 
up to 4x the performance of its predecessor. 
All of which gives your product plans an 
enormous amount of continuity. And that’s 
not going to change. Since the 68030 supports 
both MS-DOS” and UNIX® V.3, you can 
have your pick of over $12 billion worth 
of applications— and the broadest pos- 
sible market. 


With Motorola, you can see forever. 

Our plans for the rest of the 68000 fam- 
ily extend well into the future, offering 
continuing compatibility and leading- 
edge performance. So you can go with 
Motorola, not just for what our micro- 
processors can do now, but what you'll 
be able to do with them later on. 

For more information about the new 
68030, call us toll-free at Bred or 


write, Motorola Semi- 
oy 
mein 


conductor Products, Inc., 
P.O. Box 20912, Phoenix, 
(AA) MOTOROLA 


AZ 85036. 
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allowance of C, Assembly, Forth, Pascal, 
BASIC or Modula-2? Subscribe to Dr. Dobb’s 
Journal of Software Tools and you won’t catch 
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Each month the Doctor brings you aid for 
ailing algorithms and the cure for common 
code. For the latest developments in 
software design and pages of code that will 
make you a more productive programmer, 
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For more than a decade, the programming 
elite have known Dr. Dobb’s Journal to be 
the foremost source of software tools. 
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from the Doctor. 
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MAC DATA BASE 
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box with C. Berkeley, Calif.: Sybex, 
1986. 

TML Systems. MacLanguage Series 
Pascal User's Guide and Reference 
Manual. Jacksonville, Fla.: TML Sys- 
tems, 1985. 

Wirth, Niklaus. Algorithms + Data 
Structures = Programs. Englewood 
Cliffs, N.J.: Prentice-Hall, 1976. 
Wootton, Alan. “Resource Utility DA 
with TML.” MacTutor (November 
1985). 


Uses 


nesourees 


Author © 


} 
DDI (si 
{$I 
{$I 
{$I 


(Listings begin on page 48.) 
Vote for your favorite feature/article. 


Circle Reader Service No. 7. 


DAMacMan. 
DAOthers. 


DAThree.imp _ 


| _pascay source: 
“ Misize. Int 
“paMacMan- int 
: DAOthers. imp 
- DAThree. imp 
DAIndex 


Manual 
a DAMacMan.R 


Creation bate: 
Cs Abdullah Al-Dhelaan 


MMSize. Int 


DAMacMan; _ 
t DAMacMan is an online inside macintosh, running, asa esk 





_DAMacMan. pas rue 


The Manual Size, ‘Generated 
by config ' 
The Interface tagiode file 
Our own procedures and functicns  —=S=—rs—eT 
The open, Ctl, Close procedures  . 
Index To Database Entries ef 
Database from Inside Macintosh 





July ist, 1986 


(TGL Software Development Group 2 
Oregon State University 


{ The next. four tnevude files below are Interface ko Toolbox . 
MemTypes. ipas } . 
QuickDraw.ipas } 
OSIntf.ipas 
ie ces. 


{The Maoues Size, Generated  —rr—eEB 

by ong Tool a 

{ The interface include file ) 
{ Our own procedures and functions b 
es open, Ctl, Close ‘Precean ee 7 


tat 
Ge } 





Example 6: The DAMacMan main program 


Make your C language 
programs memory resident 
with 
DMS RESIDENT-C 


Lattice: Microsoft 


“hot-key” enable 


$79.95 $149.95 


w/source 


Make your assembler 
programs memory resident 
with 


DMS RESIDENT-ASM 


$149.95 
w/source 


American Software International 
P.O. Box 523 
Windsor, CT 06095-9998 
(203) 688-5054 
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Introductry Offer $99.95 


The added plus you need for developing sophisticated 
computer graphics, CAD, and programs that use 
computational geometry. 


You save time and 
money with its 
flexibility. 


TurboG 


An excellent addition 
to Borland's Turbo 
Graphix Toolbox:7 


Over 150 ready to use routines, such as Equations of 
Lines, Circles, Arcs & Planes « Intersection of Lines, 
Circles, Planes * Curves « 2&3 Dimensional 
Transforms « Polygons « Hidden Lines * Volumes » 
Areas  Prespectives * Polygon Clipping and more.... 


Manual, full source code and sample programs.All for 
the introductry price of $99.95US. Add $5.00 for SH. 
Tex Res add 8% ST. 30 day money back guarentee. 
VISA,MC,Check MO accepted. Needs Turbo Pascal 
2.0+, IBM PC(Comp),Zenith Z100,MS/PC DOS 2.0+. 


DISK SOFTWARE, INC. , 2116 E Arapaho, # 487 


Richardson, Texas 75081 (214) 423-7288 
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Listing Twelve (Text in December.) 
EXTERNS.H 


/* 


1 
2 This include file contains all of the external symbol definitions 
3 for modules that refer to external data. 
4 */ 
“Product of the Month" 5 
".. a technological tour de . Re ere 
force for fast PC graphics." 8 extern unsigned int load_segment ; 
9 extern SEG DESCRIPTOR *seg list ; 
NO ROYALTIES! 10 
11 extern char config fname[FILENAME], abs _fname{FILENAME] ; 
12 extern char module name{FILENAME], locate _fname (FILENAME) 
13 extern char print_fname({FILENAME], exe_fname(FILENAME) ; 
14 extern char map_ fname [FILENAME], tmp_ fname {FILENAME} ; 


®e 


16 extern char command_line[{COMMAND LINE} ; 


18 extern int tmp file ; 
19 extern int abs_ “file 3 
20 extern int exe “file ; 


22 extern FILE *map_ file ; 
23. extern FILE *print file ; 


MetaWINDOW provides a an oper 24 extern FILE wcontig. Stle°4 
: 2 
S ed set of grap hic draw ing functions, 26 extern BOOLEAN boot rec, help, config, user abort, hex_name ; 
{plus the added functionality and = 
performance required for designing 27 a 
multi-window desktop applications. 28 fendif End Listing Twelve 
Listing Thirteen 
¢ auto-cursor tracking 
GLOBALS.H 
¢ pull-down menus a 
¢ pop-up windows 2 This module contains all of the global data declarations 
a FZ 
° 4 
eee ne 5 #ifndef GLOBALS 
graphic functions fo? 6 
, 7 unsigned int load segment ; 
¢ multiple fonts sat aoe 8 SEG DESCRIPTOR *seg list ; 
oO ltalic 


10 char config fname(FILENAME], abs_fname[FILENAME] ; 
11 char module name({FILENAME], locate _fname (FILENAME} 


=e 








>. Tk ee ee 12 char print _f£name[(FILENAME], exe _ fname (FILENAME) : 
Disp lay multip le bitmap a 13. char map_ fname [FILENAME], tmp_ fname{FILENAME]) ; 
filled-outline" fonts. 14 
- Face fonts for bold, italic, under- . char command_line (COMMAND LINE} ; 
line or strike-out stylings. 17 int tmp file ; 
¢ Full "RasterOp" transfer 18 int abs file ; 
functions for writing, erasing, lesan oe 
rubberbanding or dragging: 21 FILE ‘map file ; 
lines, text, icons, bit images 22 FILE ‘*print_file ; 
" S, bit ge 23. FILE *config_ file ; 
and complex objects. 24 
¢ Create pop-up menus, 25 BOOLEAN boot _rec = FALSE, help = FALSE, config = FALSE ; 
windows and icons 26 BOOLEAN hex_name = FALSE, user_abort = FALSE ; 
; 27 
¢ Supports IBM's new PS/2 VGA 28 §$define GLOBALS 
and MCGA graphics. 29 
30 ftendif 
31 
32 
33 
34 
35 End Listing Thirteen 
36 
Listing Fourteen 
Loc.H 
1 define MAX_TOKEN 80 
2 f#define MAX LINE 80 
3 tdefine FILENAME 80 
4 #define COMMAND LINE 256 
5 
6 fdefine PAGE SIZE 512 
7 
8 fdefine ERROR 0 /* Error condition exists */ 
9 define OK 1 /* No error(s) detected */ 
10 
11 define T_EOL ~<e /* Reached the end of a line */ 
12, fdefine T_ERROR -1 /* Detected an error condition */ 
13. fdefine T_OK 0 /* Everything fine */ 
14 define T_OCT 1 /* Octal format integer */ 
15 define T_DEC 2 /* Decimal format integer */ 
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16 f#define T_HEX 3 /* Hexidecimal format integer */ 
17 #define T WORD 4 /* Symbol character string */ 

18 ‘#define T_OP 5 /* Operator character string */ 
15 


20 typedef enum { FALSE = 0, TRUE } BOOLEAN ; 
22 ftdefine low byte (x) ((x) & Oxff) 


23 fdefine high byte (x) (low _byte((x) >> 8)) 
24 ‘tdefine dim(x) (sizeof (x) /sizeof (x[(0]})) 
25 

26 typedef struct { 

27? unsigned int signature ; 

28 unsigned int length ; 

29 unsigned int pages ; 

30 unsigned int reloc items ; 

31 unsigned int header size ; 

oa unsigned int min_para ; 

33 unsigned int max_para ; 

34 unsigned int stack seg disp ; 

33 unsigned int initial _sp ; 

36 unsigned int checksum ; 

ae unsigned int initial pe ; 

38 unsigned int code seg disp ; 
39 unsigned int first_reloc item ; 
40 unsigned int overlay | num ; 

41 } EXE_HEADER ; 

42 

43 

44 typedef struct sym list { 

45 struct sym list *next ; 

46 char name(32) ; 

4? unsigned int value ; 

48 unsigned char type ; 

49 } SYMBOL LIST ; 

50 

Sl typedef struct seg descriptor { 

§2 struct seg descriptor *next ; 
53 long position ; 

54 char name(32) ? 

S$ char class(32) ; 

56 unsigned int vseg ; 

$7 unsigned int pseg ; 

58 unsigned int offset ; 

59 unsigned int len ; 

60 int inited ; 

61 int romable ; 

62 unsigned int symbols ; 
63 SYMBOL LIST *symbol list ; 
64 } SEG _DESCRIPTOR 3 

65 


66 char *load exe file() ; 
67 SEG DESCRIPTOR *build_ seg list() ; 


69 int get_ch() ; 
70 int unget_ch () 
71 char *get_ cmd () 
72 jochar *get _line() : 


Se Be 


74 int get_token() ; 


76 char *get_mem(unsigned long) ; 
77 void free _mem(char *) ; 


79 char *process command _line({) ; 
80 void read symbol table(SEG DESCRIPTOR *) ; 


82 void output_hex_OMF (int, SEG DESCRIPTOR *, unsigned char *) 


83 void open_file system() ; 
84 void close file system() ; 
85 void break handler() ; 


86 

87 ‘define DATA_RECORD 0 
68 define EOF RECORD ; 
89 #define ADDR_RECORD 2 
90 f#define START_RECORD 3 


92 void write START_record(int, unsigned char *) ; 
93 void write . _ADDR _record (int, unsigned int ) ; 


$4 void write | “DATA _ _record(int, unsigned int, unsigned char *, 


95 unsiqned int ) ; 
96 void write EOF record(int) ; 
97 void output | hex _record(int, unsigned char, unsigned int, 


98 unsigned char *, unsigned char) 


End Listing Fourteen 


Listing Fifteen 
page 60, i32 
name startup 


title LOCATE Example ROM System Startup Code 
subttl Turbo C 1.0 Version 


ewnry 
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(continued on next page) 


GE! 
THE 
BASIC 
FAGTS 


ApBasic*’ the original basic 








~ compiler that offers a real debugger 


feature, with single-step, watch 
variables and breakpoints. 


Plus, on-line help for language, one 
megabyte of code space and string space, 
a true native code compiler (no psuedo- 
code) and structured code. And, because 
it’s ApBasic, there’s more! 


Editor Features ¢ Fast full screen editor 
with undelete lines, block copy and move, 
search and replace, one keystroke to 
compile and run * Language Features ° 
8087/80287 support « Alphanumeric line 
labels, no more line numbers « Multi-line if 
statements « Supports DOS 3.xx networks « 
Named constants « Text windows « 
Modular sub-programs and multi-line 
functions with local, static and global 
variables up to 64K of code each « 
Debugger Features ¢ Up to twenty 
breakpoints « Up to ten watch variables 
View output screen while in debugger ¢ 
single-step or go to line with cursor « 
System Features « Source code toolboxes 
available soon « Creates stand-alone .EXE 
files or smaller chain files * Compact 
compiler, runs easily on a single 

diskette computer. 


When you get the facts, 
there is a basic difference. 


—=ApBasic= 


BY COMPTECH 


1-904-497-4810 


Comptech Software and Consulting, Inc. 
PO. Box 280, Ft. White, FL 32038 
TELEX 910 - 250 - 4832 COMTECH UQ 
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Listing Fifteen (Listing continued) 


ROM System Startup Code for Turbo C 1.0 
Copyright (C) 1987 by Rick Naro. All rights reserved. 


Segment and group declarations 


text segment byte public ‘CODE’ 
text ends 

etext segment para public ‘CODEEND' 
etext ends 

data segment para public ‘DATA’ 
data ends 

bss segment para public ‘BSS' 
bss ends 

bssend segment byte public ‘BSSEND' 
bssend ends 

stack segment para stack *STACK' 
Stack ends 


dgroup group data, _bss, _bssend 
assume cs: text, ds:dgroup, ss:_stack 


This version of the startup code expects 32-bit code pointers. 
(medium or large memory models) 


extrn _main : far : Change to near for small/compact memory model 
_text segment 

public start 

start proc far 


eli 7 Disable interrupts 


(continued on page 46) 


All MASM features (except 386 & CodeView support) 


PIUS *Generates smaller code! (no inserted NOP’s) 
*Automatically handles jumps out of range 
*Handles most of MASM’s phase errors 


*Built in MAKE , 
*Up to 15,000 symbols OPTASM 


*Simplified segmentation $1 95 
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Turbo Tech Report 
Speaks Your Language. 





TURBO 


REPORT! 
Turbo Watch 


eis 


Turse Tech Report will make 
2 point io address the #ntire 
Turse Pascal srograinmin, 


a 
community, by discussing the 
issue of porting code across 
the three Turbe Pasoai 
grvirer Maikemaliva? Expression Parsers for 

<= Renting Evalusizon 
ay Ss 


IN THIS ISSUE: 


PSS 
Puste? esd Ceicuistor 











The newsletter/disk publication for Turbo Pascal® users 


Are you looking for powerful utilities written in Turbo 
Pascal that you can use to develop software or incorporate 
into your programs? Are you interested in improving and 
expanding your Turbo Pascal programming skills? 

Then you deserve a subscription to Turbo Tech 
Report, the bimonthly newsletter /disk publication from 
the publishers of Dr. Dobb’s Journal and Micro/Systems 
Journal. Each issue delivers more than 250K of Turbo 
Pascal source code programs on disk, and 24+ pages of 
articles, Turbo Pascal software and book reviews, and 


analysis and commentary. 
It’s the only publication 
delivering such focused tech- 
nical articles with code on 
disk. Each valuable issue 
contains: 

¢ Articles on topics like 
speedy 3D graphics, math- 
ematical expression parsers, 
creating global gotos, mem- 
ory resident and AI applica- 
tions and more—all written 
by Turbo experts. 

e Reviews of the latest 
Turbo Pascal software pro- 
grams from companies like 
Borland International, Blaise 


Ne ee ET SS oe 


—Yes! I want a one-year subscription to Turbo Tech Report (6 
issues with 6 disks) for $99. 

Format: [ | PC/MS-DOS [_] Macintosh 

CP/M:  [_] Kaypro [_] Osborne ([_] Apple 


PAYMENT MUST ACCOMPANY ALL ORDERS 


[_] Check/money order enclosed. 














[_] Charge my: —— VISA ~——M/C — — AmExp. 
Card * Exp. 
Signature 

Name 

Address 

CY ee eee SETS Zip 





Orders outside U.S.: add $30. 
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Computing, Media Cybernetics, Nostradamus, and more! 

e News and commentary detailing the latest 
products and developments in the Turbo Pascal 
programming community. 

¢ A disk filled with Turbo Pascal code! You'll get 
the Turbo Pascal utilities and routines discussed in the 
newsletter’s articles, as well as applications developed by 
Turbo users from around the world. You'll receive 
programs that make labels, generate menus, provide 
faster screen access, transfer files, and more! 


If you're an expert Turbo 
Pascal programmer or a 
novice interested in 
expanding your Turbo skills, 
you need a publication that 
speaks your language: Turbo 
Tech Report. Subscribe 
today at the special price of 
just $99—that’s 33% off the 
regular price of $150. To 
order by credit card, call toll- 
free 1-800-533-4372. Or 
mail the coupon with your 
payment to Turbo Tech 
Report, 501 Galveston 
Drive, Redwood City, CA 
94063. 


function libraries 
fe [Fe T taal) (16 
compilers 


text editors 


iy em@ iis 


communications support 


text formatters = 


acu 1 CU e U Sars’ G rou p 
bulletin boards ; 
co-routines L , bra ae 


compiler compilers 
window packages ; 
A Directory 

of Public Domain 
games C Source Code 


Ft laa) elie) 


tutorials 

math packages 
link editors 
languages 

cross compilers 
pre-processors 
function libraries 
disassemblers 
compilers 


ie -rell Cele 
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XenoFont 


text. screen printing 





printing 

highest quality 
accurate images 

Pye baetets 
cursor on/off | 
great for documentation 


for only $49.95 +S/H 











: lets your 
Hos program formats 
pramiterrormat over 300 
Read’ | 


$79.95 + $5.00 S/H Sales Tax if CA. 


<ENGSREr 


1454 Sixth Street, Berkeley, CA 94710 


mee (415) 525-3113 GB 
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ICs PROMPT DELIVERY! 


SAME DAY SHIPPING (USUALLY) 
QUANTITY ONE PRICES SHOWN for NOV. 22, 1987 


OUTSIDE OKLAHOMA: NO SALES TAX 


DYNAMIC RAM 
Mbit 1048kx1 100ns $29.50 & 
1Mbit 256Kx4 120ns 34.00 ® 
51258 x 256Kx1 100ns 6.95 
4464 64Kx4 150ns 3.60 
41256 256Kx1 80nSs 5.75 
41256 256Kx1 100 ns 5.15 
41256 256Kx1 120 ns 3.95 
41256 256Kx1 150 ns 3.55 
41264 + 64Kkx4 5 .. ns 5.25 


+ 
° 


i 


4 
087-2 80287-8 80387-16 %&2, 


8 
$160.00 $245.00 $510.00 


EPR 

27C1000 128kx8 150ns $37.95 
27C512 += 64kxs 200ns 15.50 
27256 32Kx8 250 ns 5.95 
27128 16Kx8 250 ns 5.75 

STATIC RAM 
43256L-12 32kx8 120ns 
5565PL-15  8kx8 150 ns 


640K MOTHERBD UPGRADE: Zenith 150, 
IBM PC/XT, Compag Portable & Plus; hp Vectra 


OPEN 6%/2 DAYS, 7:30 am-10 pm: SHIP VIA FED-EX ON SAT. 


SUNDAYS & HOLIDAYS: SHIPMENT OR DELIVERY, VIA U.S. EXPRESS MAIL 


SAT DELIVERY MasterCard/VISA or UPS CASH COD 
INCLUDED ON | Factory New, Prime Parts Poo 
RECEIVED By. | MICROPROCESSORS UNLIMITED, INC. 
Th: Sti Air $4/1 Ih 24,000 S. Peoria Ave.., 918 267-4961 
Fr: P-1 $10.50/2 Ib BEGGS, OK. 74421 
: No minimum order. Piease note that prices are subject to 
change. Shipping & insurance extra, & up to $1 for packing materials. Orders received by 





9 PM CST can usually be delivered the next morning, via Federal Express Standard 
Air @ $4.00, or guaranteed next day Priority One @ $10.50! 
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DOS LOCATE UTILITY 





Listing Fifteen (Listing continued.) 


78 me Se te Se Be TP Se we we we TO 


70 es Be Be % 


Be ee ee 


se a, 


start 


_text 


_etext 
public 


tend 
text 


_data 
public 
idata 
_data 


_bss 
public 
bdata 


_bss 
_bssend 
public 
edata 
_bssend 


_stack 
public 


tos 
_stack 


Initialize the stack segment and pointer 


mov ax, _stack ; Get the stack segment value 
mov 53, ax ¢ Put in SS 
mov sp, offset tos # Load the TOS in SP 


Set up the segment registers for the initialization of DGROUP. 
ES is initialized to DGROUP and DS is initialized to the copy of 
DGROUP in ROM, 


mov ax, dgroup ; Get the segment for DGROUP 
mov es, ax ¢ Install in ES 

mov ax, etext * Get the etext segment 

inc ax # Adjust for the size of etext 
mov ds, ax # Install in DS 


Copy the copy of the initialized data segment _DATA from its 
position in ROM (just after the CODE class) to the real _DATA 
segment in RAM. The size of the DATA segment is computed by 
subtracting the start of DATA (the label idata) from the start 
of the next segment (the Tabel bdata). 


mov si, offset DGROUP:idata ; Starting offset of _DATA 

mov di, si # Same offset, different segment 
mov cx, offset DGROUP:bdata ; Get the end offset 

sub cx, di # Subtract the two for a length 
rep movsb z Copy initialized data 

push es ¢ Get the value of DGROUP 

pop ds # Now it is in DS 


C expects that the BSS segment is cleared when the program is 
started. Zero out the BSS segment within DGROUP by computing 
the size using the label bdata and edata labels 


xor al, al + Use a zero fill pattern 

mov di, offset DGROUP:bdata ; Get the starting offset 

mov cx, offset DGROUP:edata ; Get the ending offset 

sub cx, di # Subtract the two for a length 
rep stosb + Zero out the BSS 


Call main and hopefully never return ... 


sti + Re-enable interrupts 
call _main # Call main() 
# 


Handle a return by restarting the entire process 
ta 


jmp start 3; Start all over 
endp 


ends 


page 

segment 

tend 

do 16 dup (7?) Force alignment of the label 


tend with the next paragraph 


me te Me Be 


label byte Mark the end of the segment 
Do NOT change this segment 

ends 

segment 

idata 

label byte # Start of the DATA segment 

ends 

segment 

bdata 

label byte # Start of the BSS (and the 

7 end of the DATA segment 

ends ‘ 

segment 

edata 

label byte Mark the end of the BSS 

ends 

ue 

segment 

tos .. 7 Make the TOS public 

dw 256 dup (?) # Declare the stack size 

label byte : Define the top of stack 

er.ds 

end start ‘ 


End Listings 


nee, 
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Clarify and document your source listing and get 





an “organization chart” of your program’s structure 


with two NEW utilities from Aldebaran Laboratories, for C, BASIC, 
Pascal, d(BASE® FORTRAN and Modula-2 programmers 


“Occasionally, a utility 
comes along that makes a 
programmer’s life much 
easier. SOURCE PRINT 
is such a program. 

It contributes to the 
programmer’s job by 
organizing code into a 
legible format and by 
helping to organize the 
documentation and 
debugging process.” 


— PC Magazine 
Sept. 16, 1986 


Source Print and Tree Dia- 
grammer both have easy-to-use 
menus with point-and-shoot file 
selection, and let you search for 
files containing a given string. 
For IBM PC and compatibles 
with 256K. 

Join thousands of program- 
mers who are working more 
efficiently using Source Print 
and Tree Diagrammer. Order 
these indispensable tools today. 
We ship immediately, and 
there’s no risk with our 60-day 
money-back guarantee. Order 
both and save. Only $155.00. 


800-25 7-9 Sia Dept. 58 


In California: 


800-25 7-9 7/4 Dept. 58 


MasterCard, VISA, American 
Express, COD. Add $5 for 
shipping/handling. 


or see your local dealer! 


Source Print and Tree Diagrammer are 
trademarks of Aldebaran Labs. dBASE is 
a trademark of Ashton Tate. Prices subject 
to change without notice. 










Source Print” 


organizes your source code, simpli- 
fies debugging, and makes documen- 
tation a snap! It lists one or more 







150 FOR INDX = 1 TO 100 
160 IF TB(INDX) = O THEN X = 5 

170 C = 50: WHILE K <= 1000: TB(K) = 0: K = K + X: WEND 
180 GOSUB 2000 

190 XT(C) = X: T2(C) = K: C=C +1 
200 NEXT INDX 







—FOR INDX = 
160 IF TB(INDX) = 0 THEN X = 5 


1 TO 100 










170 = 50 
source files with informative page tek) = 0 
; Before La 

headings and op- 1g0 | Gasp 2000 

: : 1 XT(C) = X 
tional line numbers, mea 
while offering — (iar < nres && ares({iar](0] == c) 200 "—WEXT INDX 
= if ((d = ares{iarj({1])) == 0) 
invaluable features: ba alaieeteaeieyes: 

while (d = *p) 
The Index oe 


Wed 12-31-86 07:22:03 INDEX (Cross Ref) 
all identifiers 


(Cross-Reference 
list) saves you time 
by showing exactly 
where variables are 
used and where functions, pro- 
cedures, and routines are called. 
Locations where new 
values may be assigned to 
variables are shown, making it easy to track down that 
mysterious value change. 

Structure Outlining solves the problem of hard-to- 
see nested control structures by automatically drawing 
lines around them. 

Automatic Indentation of source code and listings 
reduces your editing time and ensures indentation accuracy. 


Plus... Source Print generates a table of contents 
listing functions and procedures. Keywords can be printed 
in boldface on most printers. Multi-statement BASIC lines 
can be split for readability. Functions and procedures can 
be drawn by name from one or more source files to form a 
new file. 


Tree Diagrammer” 


shows your program’s overall organization at a 
glance. Ordinary program listings merely display 
functions, procedures, and subroutines sequen- 
tially, but do not display the relationships be- 
tween these routines. Our revolutionary new 
Tree Diagrammer automatically creates an 
“organization chart” of your program showing the 
hierarchy of calls to functions, procedures, and 
subroutines. Recursive calls are indicated and 
designated comments in the source code 
will appear on the chart. 

Tree Diagrammer helps you organize your 
program more logically. And you’ll be amazed at 


how easy it is to debug when you $7 700 


inrecord 4.191 9=396 19.825 19=826 
2 22.922 22.953 23=978 





ins 53.2293 53=2309 53=2319 53.2325 


54.2331 54.2332 54.2336 54=2346 
00 54.2354 54.2364 54.2365 54.2366 
intext 4.193 9=395 43.1796 43.1815 


43=1820 45=1902 
Index 





Tue 01-06-87 00:28:44 
01-06-87 00:05:14 SALES.C 





see how your routines interact. 


Aldebaran Laboratories 3339 Vincent Rd. Pleasant Hill,CA 94523 415-930-8966 


YES Rush ME Source Print @ $97. ______ [] Tree Diagrammer @ $77. 
C Both $155. Ship/Handling $5. For CA add 6% tax —______L__ Total 

Name 
Company 
Address 
City State 
[]Checkenclosed [IJVISA []MasterCard [J] American Express 
Card # Exp. Date 


Signature Phone -. ...CULM 











Zip - 
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~ MAC DATA BASE ~ 





Listing One (Text begins on page 24.) 


DAMacMan.r Resource 
July 3, 1986 Last modified 


Resource file for "DAMacMan.pas" for use with MacLanguage 
series Pascal Compiler (TML Pascal) 


all resources must be between -15872 and -15841 inclusive 
if they are to travel with DRVR number 16 


+ + ¢ 6 He HH NH F 


MacManFile 
DF ILDMOV 


TYPE DRVR = PROC 
MacMan, 16 
DAMacMan 


* this DLOG is the main window. 
* the StatText items are used only for their rectangles. 


Type WIND 
7715872 

Untitled 

50 40 300 510 

InVisible GoAway 

0 

0 


* menu used by the DA 


type MENU 
, 715872 
Macman 77 menu title 
about Macman 
(- 
Find By Name 
View By Category 


* This second dialog is for about menu item 
* the button and icon do nothing. Just decoration 


Type ALRT 
2715872 

50 50 330 430 

-15872 

4444 


2715871 
50 50 300 480 
~15871 
4444 


» 715870 
60 80 126 430 


-15870 7 
4444 End Listing One 


® 
Listing Two 
{ 
DAMacMan.int Interface 
July 3, 1986 Last modified 


An interface file that Contains all the needed types and vars 


} 


Const 


accEvent = 64; 


accRun = 65; 
accCursor = 66; 
accMenu = 67; 
accUndo = 68; 
accCut = 70; 
accCopy = 71; 
accPaste = 72; 
accClear = 73; 
ManFile = 'Manual'; {Name of Database File} 
Vnum = 0; {default drive} 
Type 
Str25 = String [25]; 
Lptr = “LongInt; 
Item = Record { An entity record} 
name : Str25< { Proc/Func. Name } 
start : LongInt; { Starting pos. on the Manual } 
length : Integer; { Length of Proc./Func. Text } 
gine : Integer; { Category # } 
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ptrl -= “* item; 


myarray = ARRAY [1..MaxRec] of Ptrl; { The main array } 


{This is the data. A handle to it will be stored in the dctl storage field 
of the DCltEntry Record } 


GlobalsH = “*GlobalsP; 

GlobalsP = *GlobalsRec; 

GlobalsRec = Record { DAMacMan Database Info } 
hScroll : ControlHandle; 

{Horizontal scroll for window. } 
vScroll : ControlHandle; {Vertical scroll for window} 
pRect : Rect; {Rectangle within window to see} 

tRect : Rect; 
hTE : TEHandle; {Text is here...} 
table : myarray; {Index to entries} 
noIndex : boolean; {Error if no Index on Disk} 


noman : boolean; {Error if no Database on Disk} 
END; 


{ This is used to store system info about the state of the driver. It will 
be passed to us on all calls from system. This Record is definded in the 
interface (TML files) above (as DCtlEntry) . it is not strictly necessary to 
redefine it here. But doing so, will enable me to use dctlStorage** to 
refer to GlobalsRec without coercing Types } 


MyDeviceEntry = Record 

DctlDriver : HAndle; { Pointer to driver } 
DetlFlags : Integer; { Flags } 
DetlQueve : Integer; { Low-order byte, drivers version number } 
DetlQhead : Lptr; { Pointer to first entry in drivers I/O queue } 
Det 1QTail $.Lptr: { pointer to last entry in drivers I/O queue } 
DetlPosition: LongInt; { Byte position } 
DetlStorage : GlobalsH; { Handle to RAM driver's private storage } 
DetlRefNum : Integer; { Driver's reference number } 
DetlCurTicks: LongInt; { Used internally by Device Manager } 
DetlWindow : Grafptr; { Pointer to driver's window Record } 
Dect 1lDelay : Integer; { number of ticks between periodic actions } 
Dect lEmask : Integer; { Desk accessory event mask } 

Det 1Menu : Integer; { Menu ID of menu associated with driver } 

END; 


{ No VARiables for main program are allowed } End Listing Two 


(Listing Three begins on next page) 

























PRODUCTION 
LANGUAGES CORP. 


PRODUCTION QUALITY 


68020 
ANSI C Compiler 


Full 68020 instruction set 

Full 68881 support 

ANSI Standard reentrant library 
Extensive Sybolic Debug information 
Internal consistancy checking 
Position independant code 
ROMable code 








PC Hosted cross-compiler 

2 USOT ICOASE oe eis. d's Cohesion ss $1500.00 
MPULSE COMPUTERS VME Hosted native compiler 

single CPU license................. $1500.00 


THE NEXT GENERATION IN 
UNIX* PROGRAM DEVELOPMENT 


ANSI standard reentrant 
library source code................. 








MPulse Model 21 ($14,995 list) MPulse Model 20 ($9,995 list) 

* Support for 64 users * Support for 32 users S jo EC lA Ee O F Fe = i 

* 1 Gigabyte storage capacity * 0.5 Gigabyte storage capacity attr ? 2 

* 32 bit processing power * 32 bit processing power For a limited time only we are offering full 

* Multiprocessor architecture * Multiprocessor architecture library source FREE with the purchase of either 


* OS derived from AT&T UNIX System V_ * OS derived from AT&T UNIX System V 


MPulse is the first computer system ever to offer minicomputer performance 
for under $10,000. Call today to find out more about MPulse computers, and 
ask about our software developer discounts. Call (214) 340-5172 

Logic Process Corporation 10355 Brockwood Road Dallas TX 75238 
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68020 C compiler 


817-599-8366 
P.O. Box 109, Weatherford, Texas 76086 
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Listing Three (Listing continued, text begins on page 24.) 





{ 
DAThree.imp Implementatioon 
July 3, 1986 Last modified 


THE FOLLOWING PROCEDURES SHOULD BE IN EVERY DESK ACCESSORY 
AND THEY ARE CALLED BY THE SYSTEM 








PROCEDURE open ( VAR Device : MyDeviceEntry; 
VAR block : ParamblockRec}; 
{ Open Makes a window and sets-up our private storage. 
we may get an open call even after we are already open } 
CONST 
InfoLength = 700; {The number of chars. fro the distribution text} 
VAR 
Wpk : WindowPeek; 
Dtyp : Integer; 
ID : Integer; 
Dhan : Handle; 
tmpPtr.. > ptr? 
dummy : GlobalsRec; 
Watch : CursHandle; {Handle to wristwatch cursor} 
BEGIN 


{Use ID for all Resource access} 
ID := $C000 - 32 * (1 + Device.dct1lRefNum) ; 
Device.dctlMenu := ID; 
With Device do 
if DctlWindow = nil 
THEN BEGIN 
{ Create a hole in the heap. It is good practice to keep 
Window records off of the bottom of the Application Heap. } 
DetlStorage := pointer (NewHandle (SizeOf (dummy) )); 
TmpPtr := NewPtr($1000); 
Hlock (Handle (Dct1Storage) ); 
With DctlStorage** do 
BEGIN {initialize our storage } 








GraphiC“”™ WTEK™ 


can plot your | pEC™ vT100/VT52 
ata in and Tektronix™ 
publication 4010/4014/4105 

quality Terminal Emulator 


e20 user-defined keys 
escroll back buffer 
ehardware 132 columns 





Query +MANAGER= 
Q-MAN 


Q-MAN, a fast true relational data base management 
system which supports interactive and imbedded 
queries, library routines, forms, and will be multi-user 





















nape POMIEOD cave or distributed. Uses QUEL and SQL languages, B+ 
resolution on EGAs trees, and sort-merge joins. Free multi-user upgrade 






*zoom, pan, window plots when released first quarter of 1988. 


e"hot key" to DOS 



























on your IBM PC ee keyboard sup- Runs on: single-user 
. *linear, log, polar plots eANSII extensions to SYS 5 $1395 
ebar charts, Smith charts VT100 for multi-color text 42 139 
°3D curves, 3D surfaces escrolling VT100 window ; o 
°6 curve types, 8 markers on graphics screen MS-DOS™ 329 
¢14 fonts, font editor ‘ 
©4096 x 3120 resolution $150. Site and ee code 
¢zoom, pan, window plots licenses available TOLOrGe 





Call collect 
(608) 271-2171 


Breakpoint Computer Systems, Inc. 


6701 Seybold Road, Suite 204 
Madison, WI 53719 






ehigh resolution printer 
and plotter dumps in color ™ 
Over 150 Cand Assembler e a E D / } 
routines for full control = i seek 
: ur new binary editor for 
$395 with source code programmers - $29 


For personal use only 
MOST HARDWARE IS SUPPORTED 


Scientific Endesvors CL: orporation 
LS AS ES ES REST POEL TE IT CNET ESTEE © FEE SE TE PSN RES OS TS 
Route 4, Box 79 Kingston, TN 37763 (615) 376-4146 










Include machine name and operating system 
when ordering. 






Visa and Mastercard accepted. 
MS-DOS" is a registered trademark of Microsoft Corporation. 
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noindex := false; {Index found} 
noman := false; {Manual found} 
Watch := GetCursor (WatchCursor) ; 
SetCursor (Watch*%); {Indicate delay } 
CreateWindow (Device,ID); 
{ post information } 
DoOpen (Device, 'MacMan Distribution',0,InfoLength) ; 
If not noman 
Then LoadData (device); {Load the array} 
initcursor; 
END; { of with storage } 
{Deallocate our temporary pointer } 
Hunlock (Handle (Dect 1Storage) ) ; 
DisposPtr(TmpPtr) ; 
END; { of if } 
; { of open } 


PROCEDURE close VAR Device : MyDeviceEntry; 
VAR block : paramBlockRec) ; 
BEGIN 
deactivate (Device) ; { remove menu } 
with Device do 
BEGIN 
disposHandle (Handle (Dct1Storage) ); { kill data } 
disposeWindow (Dct lWindow) ; { erase window } 
DetlWindow := nil; 
END; {of with } 
END; { of close } 


PROCEDURE ctl ( VAR Device : MyDeviceEntry; 
VAR block : ParamBlockRec) ; 
{ Here is the main entry point for system calls. The permanent bolck tell us 
what the nature of the call is. } 
VAR 
mousept : point; 
wpnt : Grafptr; 
item : Integer; 
ibeam : cursHandle; 
ignore : Integer; 


1 ignor rs Int; ‘ 
ongignore ongin (continued on next page) 


copy protection and 
customer satisfaction? 


crs 8 way to protect your software. | 
ts called the Secom Key, and it works. | or more information, contact 


(_] The Key is completely transparent to the Secom Information Prod ucts Co. 


“ es ; | 500 Franklin Square 
[_} Won't interfere with peripheral operations. : BB 1829 East Franklin Street 


Chapel Hill, NC 27707 
(_} Doesn't occupy the disk drive. , 
) The Key allows unlimited backup copies. The Secom Key... 


for real 
(_) Makes site licensing easy and auditable. Bp software 
a — fi protection. 
J Easily installed. Uses only 1000 bytes. 


[_} Over 60,000 have been sold worldwide. 


_} Same size as RS-232 plug. 
_) Available in quantities for as low as $19.95. Seconr texters Peecues eee 


Call Toll-free 1-800-843-0413 
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Listing Three (Listing continued, text begins on page 24.) 


BEGIN 
setport (Device .Dct1lWindow) ; 
Hlock (Handle (Device.Dct1Storage) ) ; 
with Device, DctlStorage**, block do 
BEGIN 
TEidle(hTE) ; 
CASE csCode of 
accevent 
accCursor ; 
BEGIN 
ibeam := GetCursor(ibeamcursor); 
GetMouse (mousePt) ; 
If (PtInRect (mousePt, pRect) ) 
THEN SetCursor (iBeam*“*) 
ELSE InitCursor; 


Event (Device, block); 


END; | 
accmenu { CASE out menu item number } 
BEGIN 
Initcursor; 


CASE csParam[1] of 
1 : Doabout (Device.dctlmenu) ; {about... } 
3 : IF (not noindex) THEN DoFind (Device,''); 
4 : IF (not noindex) THEN DoView (Device) ; 
END; { of CASE menu } 
HiliteMenu (0) ; 
END; { of menu CASE } 
accCopy : 
BEGIN 
longignore := ZeroScrap; {Init. Scrap} 
TECopy (hTE) ; {Copy text from hte to TextEdit scrap} 
ignore := TEToScrap; {Copy TextEdit scrap to desk scrap } 
ignore := UnloadScrap; {Copy desk scrap to file scrap} 
END; 
Otherwise ; 
END; { CASE of ... } 
END; { of with block } 
Hun lock (Handle (Device.Dct1Storage) ) ; 
END; { of control PROCEDURE } 


End Listings 











Software Engineering in C 
P. Darnell and P. Margolis 


Designed as a text for both beginner and 
intermediate-level programmers, this new 
book makes few assumptions about the read- 
er’s prior computer experience. The book 
begins with a basic description of how source 
code is translated into its internal and execut- 
able form, and also includes many of C’s 


2 
Science 
more advanced features. As an added fea- 


from 
‘s ture, the proposed ANSI Standard is fully 
documented. 
Sp rin g er Ver lag 1987/612 pp/62 illus/59 tables/ 


Paper $29.95 (tent.) 


Springer Books on Professional Computing 


ISBN 0-387-96574-2 


New in 
Computer 


A Computer Science Reader 
Selections from ABACUS 
Edited by E.A. Weiss 


This unique new book contains selections 
from the first three and one-half years of 
ABACUS, The Magazine for the Computing 
Professional. This collection of the best from 
tax). To order by credit card, call TOLL ABACUS contains contributions from every 
FREE, 1-800-526-7254 (in NJ, 201-348- regular columnist, along with feature articles 
4033). such as “SDI: A Violation of Professional 
Responsibility’ by David Lorge Parnas; 


To order these or other Springer-Verlag 
titles, send a check or money order (plus 
$2.50 for shipping) to: Springer-Verlag New 
York, Inc., Attn: Computer Science Dept. , 
175 Fifth Avenue, New York, NY 10010 
(NY. NJ, and CA residents please add sales 


aa8 
‘Programmers: The Amateur vs. the Profes- 
sional” by Henry Ledgard, and many others. 
1987/Approx 424 pp/60 illus/11 tables/ 
. Hardcover $35.00 
Springer-Verlag ISBN 0-387-96544-0 


New York Berlin Heidelberg Vienna 
London Paris Tokyo 
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An APL Compiler 
T. Budd 


This book presents, in detail, the results of 
an investigation into the issues raised by the 
development of a compiler for APL, a very 
high level programming language. Through 
the integration of several recently developed 
compiler construction techniques, such as 
data-flow analysis, and a novel and space- 
efficient demand-driven or lazy-evaluation 
approach to code generation, the author has 
been able to produce a true compiler for the 
language while still maintaining the flexibil- 
ity and ease that are the hallmarks of APL. 


1987/156 pp/15 illus/Softcover $22.50 
ISBN 0-387-96643-9 


Coming soon. . 


Prolog by Example 


How to Learn, Teach, and Use It 
H. Coelho and J.C. Cotta 


This is a book about learning to use Prolog, 
and teaching Prolog through examples. The 
book contains a large collection of problems 
with corresponding programs and comments. 
Prolog by Example is also a guide to soft- 
ware research in Prolog and, as such, 
presents programs to be used as building 
blocks in larger systems. An important 
source of information for introductory as 
well as advanced Prolog users. 


1987/Hardcover in preparation 
Symbolic Computation 
ISBN 0-387-18313-2 
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“How to protect your software 
by letting people copy it-’ 


By Dick Erett, President of Software Security 


Inventor and 
entrepreneur, 
Dick Erett, 
— = ___ explains his 
LS © company’s 

~ <BR N@ view on the 
protection of intellectual 
property. 


66 crucial point that 
even sophisticated 
software develop- 


ment companies and the 

trade press seem to be miss- 

ing or ignoring is this: 
Software protection must 
be understood to bea 
distinctively different 
concept from that com- 
monly referred to as 
copy protection. 


Fundamentally, software 
protection involves devising 
a method that prevents 
unauthorized use of a 
program, without restricting 
a legitimate user from 
making any number of 
additional copies or prevent- 
ing program operation via 
hard disk or LANs. 

Logic dictates that mag- 
netic media can no more 
protect itself from misuse 
than a padlock can lock itself. 

Software protection must 
reside outside the actual 
storage media. The technique 
can then be made as tamper 
proof as deemed necessary. 
If one is clever enough, 
patent law can be brought 
to bear on the method. 

Software protection is at 
a crossroads and the choices 
are clear. You can give 
product away to a segment 
















S 


Hard Disk Installation : Simply copy program disk 
to hard disk using DOS Command - Copy A:*.* C 


the program diskette as you wish. 


Data Back-ups : Use normal back-up and restore 
commands, including backing up sub-directories containing 


program files. 








Ussgll o A Networks : This product may be 





Program Back-ups : You may make as many copies of 


s. Follow the same installation 
page 102 of this manual. The Block 
with the normal operation of any 


Soon all software installation procedures will be as straightforward as this. 


3 
e | 
> 
¢ 





The only difference will be whether you include the option to steal your 


product or not. 


of the market, or take a 
stand against the theft of 


~ your intellectual property. 


‘“.. giving your software 
away is fine...” 


We strongly believe that 
giving your software away 
is fine, if you make the 
decision to do so. However, 
if the public’s sense of ethics 
is determining company 
policy, then you are no 
longer in control. 

We have patented a device 
that protects your software 
while allowing unlimited 
archival copies and unin- 
hibited use of hard disks and 
LANs. The name of this 
product is The BLOCK™ 

The BLOCK is the only 
patented method we know 
of to protect your investment. 
It answers all the complaints 
of reasonable people con- 
cerning software protection. 


In reality, the only people 
who could object are those 
who would like the option 
of stealing your company’s 
product. 


‘“<..eliminating the ratio- 
nale for copy-busting...”’ 


Since The BLOCK allows 
a user to make unlimited 
archival copies the rationale 
for copy-busting programs 
is eliminated. 

The BLOCK is fully pro- 
tected by federal patent law 
rather than the less effective 
copyright statutes. The law 


clearly prohibits the produc- 


tion of work-alike devices 


to replace The BLOCK. 





The BLOCK attaches to 
any communications port of 
virtually any microcomputer. 
It comes with a unique 
customer product number 
programmed into the circuit. 

The BLOCK is transpar- 
ent to any device attached to 
the port. Once it is in place 
users are essentially unaware 
of its presence. The BLOCK 
may be daisy-chained to 
provide security for more 
than one software package. 

Each software developer 
devises their own procedure 
for accessing The BLOCK 
to confirm a legitimate user. 
If it is not present, then the 
program can take appro- 
priate action. 


‘‘,. possibilities... 
limited only by your 
imagination...” 


The elegance of The 
BLOCK lies in its simplicity. 
Once you understand the 
principle of The BLOCK, 
hundreds of possibilities will 
manifest themselves, limited 
only by your imagination. 

Your efforts, investments 
and intellectual property 
belong to you, and you have 
an obligation to protect 
them. Let us help you safe- 
guard what’s rightfully yours. 
Call today for our brochure, 
or a demo unit.” 





oftware 


wf, 


CCUF i Y inc. 
870 High Ridge Road Stamford. Connecticut 


06905 


203 329 8870 
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/* 


custom controls demo.c 


c source code file for a minimal Mac program that demonstrates 
controls drawn with a custom CDEF resource 


the custom CDEF resource that's demonstrated provides 16 button 


variations 
the buttons .. 
° .. live in a rectangular space 
° .. can be outlined, shadowed, or bare 
° .. Can contain text in any font-style-size, an icon, or 
a picture 


° .. can indicate highlighting via inversion or a change 
of content 


edited and compiled with Lightspeed C 2.13 


written and ©1987 by Stan Krute. all rights reserved. no part of this file, 
or the object code it leads to, may be reproduced, in any form or by any means, 


without the express written permission of the author and copyright 
holder. 
timestamp: 3:49 pm PST November 16, 1987 
spacestamp: 18617 Camp Creek Road Hornbrook, €alifornia 
96044 
this file looks good in 9 point Courier, LSC tabs set to 3 
=f 
[ Bmw mn nn nn nn nn nn = include files ----------------------------- Tr 
/* definitions for Mac OS managers used herein */ 
#include “ControlMgr.h" 
#include “DialogMgr.h" 
#include “EventMgr.h" 
#include “FontMgr.h" 
#include “MenuMgr.h" 
#include “Quickdraw.h" 
#include "StdFilePkg.h" 
/* our stuff */ 
#include “custom controls demo.h" /* private definitions for this 
file */ 
[ ¥en nn nnn - - - - - - - - -- - - - - +--+ main program block ---------------------------- =/ 


/* local variable */ 
int theItem ; 


/* initialize Mac OS managers */ 
initializeManagers() ; 


/* see what the world is like */ 
studyAndSetEnvironment () ; 


/* set up and draw a (dummy) title menu */ 
InsertMenu( GetMenu (titleMenuID), append ) ; 
DrawMenuBar() ; 


/* set up and draw a modal dialog window */ 
getThatDialogCookin () ; 


/* initalize our doneness indicator */ 
finished = false ; 


/* run the main event loop *4/ 
do 
{ 
ModalDialog (noFilterProcedure, &theItem) ; 
dealWithDialiogItem (theltan) ; 
while 
( ! finished ) ; 


/* leave neatly when done */ 


DisposDialog (ourDialog) ; /* bye bye to dialog */ 
ExitToShell() ; /* bye bye to 
program */ ; 
} 
[ Bann nnn nn nn initializeManagers ----------~----~-------~--~-~-~~-- oF 
/* initialize the heap, cursor, and Mac Operating System managers */ 





(continued on page 57) 
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Support your clients 


leaving 


your oftice! 










For*99 

pcAn ere 
gives you all that's 
needed to support 
both host and remote! 


It lets you access and run an unat- 
tended IBM PC/XT/AT/PS2 or compatible 
from any remote location. On any per- 
sonal computer. Day or night. 

And with our new IRMA interface you 
can access a mini or mainframe, too. 

This makes it ideally suited to remote 
customer service and technical support. 

Because you can identify and solve 
problems from your office PC! Saving 
valuable time and the expense of a field 


service Call. 

With pcAnywhere 
you can compress 
and then transfer a file 
from your client’s PC to 
yours, fix it, then transfer the 

file back to the client. 
Virtually any program on the client's 


PC can be controlled from your keyboard. 


As though you were sitting in front of 
the client's computer. 

Take remote control then give it back 
to your client's PC. Or keep both 
keyboards active at the same time and 
type messages back and forth. 

Call today for more information or to 
place an order. You'll find yourself in 
remote control before you know It! 


pcAnywhere is a trademark of DMA. 


on! 





764 Middle Country Road, PO. BoxY, Selden, NY 11784 * (516) 736-0500 
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Micro/Systems Journal has the answers. that M/S/ is famous for 

Whether it’s networking, systems integration, providing . ... in-depth 

programming, or scientific computing tutorials, reviews, hints, the 

questions, M/S/ will lead you out of the maze latest on multitasking, languages 

of microcomputer mayhem. With each issue and operating systems. So stop your 

you'll find comprehensive coverage of all the puzzling . . . subscribe right now and the answers 
technical information that will keep you will be yours. Simply drop the attached card 
up-to-date with the ever-changing microcom- in the mail—that’s all there is to it. 

puter industry. You'll get the hands-on, nuts ee 


and bolts information, insight, and techniques 
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Listing One (Listing continued, text begins on page 90.) 


void initializeManagers ({) 


{ 
/* local variable */ 


Handle someDay ; 


/* get some space */ 

MoreMasters() ; 

/* get some master pointers */ 

if (someDay = NewHandle (humungousBlock) ) 
DisposHandle (someDa'™) ; 


InitGraf (&thePort) ; 
InitFonts(); 


InitWindows (); 
/* set up the Window Manager */ 
InitMenus () ; 


TEInit (); 
/* set up Text Edit */ 
InitDialogs (noResumeProcedure) ; 


/* final adjustments */ 

FlushEvents (everyEvent, dontStop ) ; 
InitCursor(); 

/* turn the cursor on */ 


} 
[8 enn ern aeen= studyAndSetEnvironment 
/* check out screens, machines, ROMs, et al */ 
void studyAndSetEnvironment () 


{ 
/* check out the screen */ 
screenRect = screenBits.bcunds ; 


/* grow a maximal heap by */ 
/* asking for the future */ 


/* get those managers going */ 


/* set up Quickdraw */ 


/* set up the Font Manager */ 


/* set up the Menu Manager */ 


/* set up the Dialog Manager */ 


/* clear the event queue */ 


screenHeight = screenRect.bottom - screenRect.top ; 
screenWidth = screenRect.right - screenRect.left ; 


/* determine height of the menu bar */ 
if ( ROM8S & 0x8000 ) 
menuBarHeight = stdMBartieight ; 
else 
menuBarHeight = MBarHeight ; 


[ Bann nnn nnn = get ThatDialogCookin 
/* set up and draw our main modal dialog window */ 
void getThatDialogCookin ({) 


{ 

/* local variables */ 

Point tempPoint 
Rect scratch ; 
ControlHandle theButton ; 


/* get the dialog window */ 
ourDialog = GetNewDialog (ourDialogID, 


/* adjust its position */ 
MoveWindow ( ourDialog, 


/* for 64K ROMs */ 


/* for newer ROMs x/ 


2 
’ 


storeInHeap, inFront) ; 


(tempFoint = figureCenteredRectTLC (& (*ourDialog) .portRect)) -.h, 


tempPoint.v, inFront ) ; 


/* make dialog window the current grafPort so we can change its font */ 


SetPort (ourDialog) ; 

/* change its font to Geneva 12 */ 
TextFont (geneva) ; 

TextSize (12) ; 


/* show the dialog */ 
ShowWindow (ourDialog ) ; 


/* deal with the hit item */ 


void dealWithDialogItem (theItem) 
int theItem ; 


{ 
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Barrier 


dBase to C conversion 
is now a reality 


Sooner or later you’re going to run into the dBase wall. It may 
come up unexpectedly. Maybe you know it’s there. But at 
some point you are going to need faster run-time, real 
portability, stronger code refinement, and source code security. 


Using dBx to translate your dBase code to C is the perfect way 
to break the dBase barrier. C is portable, fast, and flexible. C 
programmers appreciate our commented, clean K&R code. If 
you are new to C, dBx is a great way to get up to speed. Why 
not call us today and discuss your individual situation. ~ 


Z\ Desktop Ai (203) 255-3400 


1720 Post Road E. 
TELEX - 6502972226MCI 


Westport, CT 06880 
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has an —attractiv 
personality. 








Listing One 
(Listing continued, text begins on page 90.) 


/* local constants */ 
#define ocolSize 6 
/* local variables */ 

static short onOffList[oolSize] = { orwellItem, hupCoupleItem, 
ronitem, saveAsItem, 


pinheadItem, ¢cuplicateItem} ; 
/* case out on the item */ 
switch (theItem) 

{ 

case quitItem: 
finished = true ; 
break ; 

case orwellItem: 
doOrwelliItem ({) ; 
break ; 

case snapshotItem: 
doSnapshotiItem () ; 
break ; 

case mushroomiItem: 
doMushroomiItem () ; 
break ; 

case openiItem: 
doOpenItem () ; 
break ; 

case saveAsitem: 
doSaveAsItem () ; 
break ; 

case flipItem: 
doFlipItem () ; 
break ; 

case someOffitem: 
doSomeOffitem (onOffList, oolSize) ; 
break ; 

case someOnItem: 
doSomeOnItem (onOffList, oolSize) ; 
break ; 

case copyrightItem: 
doCopyrightItem () ; 
break ; 

default: 





YS 
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“A while back | got a SemiDisk to help me with 
my database work. A SemiDisk is like a RAM- 
disk only a whole lot better. It doesn’t sit in my 
main or EMS memory, and, using the Battery 
Backup, it's like permanent storage. 


“That SemiDisk makes light work of the jobs 
that were sending my hard disk to an early 
grave. And SemiDisk has no head to crash; 
no moving parts to wear out. With all the time 
it saves me, | figure it paid for itself in just a 
couple of months. 


“Then | heard programs like Microsoft Win- 
dows could use my SemiDisk for temporary 
files instead of using EMS. So | moved them 
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over to the SemiDisk, too. The quiet speed of 
it is almost elegant! 


“My boss wanted to try my SemiDisk on the 
company LAN server, but | told him to get his 
own. A couple of days later, he was wearing 
a grin as big as mine. | guess he likes his 
SemiDisk too. 


“One morning | booted up my computer and 
there was my word processor waiting for me 
on the SemiDisk. | swear | didn’t put it there! 
After | tried it, | knew it was there to stay. 


“Meanwhile, I've found a new use for my hard 
disk, too. It's great for backing up my 
SemiDisk!” 


CIRCLE NO. 135 ON READER SERVICE CARD 


I/O mapped SemiDisk goes in standard PC, XT or 
AT expansion slot. Priced at just $495 for 512K, 
$795 for 2Mb. Battery Backup $130. Up to 8Mb 
per drive. Call or write for further information or 
to place an order. 


Semibisk 


End the waiting. 





SemiDisk Systems, Inc. 
P.O. Box GG 
Beaverton, OR 97075 
(503) 626-3104 
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break ; 
} 


/* remove local constants */ 
#undetf oolSize 


/* deal with a click of the orwellItem button */ 


void doOrwellItem () 


{ 

/* local constants */ 

#define cyclesDesired 
#define delayTicksOne 
#define delayTicksTwo 


/* local variables */ 


Rect scratch ; 
ControlHandle thelItemHandle ; 

short cycleCounter ; 
ControlHandle ronItemHandle ; 


/* get a handle to the button */ 


GetDItem ( ourDialog, orwellItem, &scratch, &theItemHandle, 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* get a handle to the ronItem button */ 


&scratch) ; 


GetDItem ( ourDialog, ronItem, &scratch, &ronItemHandle, &scratch) ; 


/* run several fade cycles on the ronItem button */ 
for ( cycleCounter = 0; cycleCounter < cyclesDesired; cycleCounter++) 


{ 
/* fade out */ 


HiliteControl (ronItemHandle, inactiveHS ) ; 


/* wait a while */ 
Delay (delayTicksOne, &scratch) ; 


/* back into view */ 
HiliteControl (ronItemHandle, activeHS ) ; 


| Now you can use QPARSER + to develop compilers, | 
| interpreters, complex user-interfaces, language & file for- 
| mat translators (i.e. Pascal to C, Bit Map to Postscript), 
| language debuggers like lint, etc. 


| Develop language translators in C and Pascal within the | 
11BM PC/XT/AT or VAX/VMS environments. A new user | 
i manual, automated syntax tree construction and an ad- { 
| vanced code generation language are just a few of the | 


| improvements over the original QPARSER. 


| Another translation by QPARSER+ 
Just $475 (Peat) — FREE demo disk available 
i QCAD Systems 


1164 Hyde Avenue, San Jose CA 95129 (408) 727-6884 
L Lm outside Cali cal TOLL-FREE (900) 598.9787 
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POWER UP YOUR 3386 


MULTI-USER DOS 


UNDER UNIX® 
In Stock - Ready to Ship 


386/lix Applications Platform 
386/ix UNIX V.3 run time 
VP/ix (DOS under UNIX) 
TEN/PLUS User Interface 
Software Development System 


INTRODUCTORY PRICE 


FOR TWO-USER SYSTEMS 
All of the Above for $894 


Unlimited user licenses and more options available 


Call now to order: 
(800) 323-8649 or (312) 987-4084 


_COMPUTER _ 
TECHNOLOGY 
GROUP 


Telemedia, Inc. 
310 S. Michigan Ave., Chicago, IL 60604 


UNIX is a registered trademark of AT&T 
MS-DOS is a trademark of MICROSOFT 
386/ix, VP/ix, and TEN/PLUS are trademarks of 
INTERACTIVE S YSTEMS CORPORATI ON 
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Listing One (Listing continued, text begins on page 90.) 


/* wait a while */ 
Delay (delayTicksTwo, &scratch) ; 
} 


/* unhilite the button */ 
HiliteControl (theItemHandle, activeHS ) ; 


/* xemove local constants */ 


#undef cyclesDesired 
#undef delayTicksOne 
#undef delayTicksTwo 
} 
[| Rem mm nnn enn nnn nnn doSnapshotItem ---------------------------- */ 


/* deal with a click of the snapshotItem button */ 
void doSnapshotItem () 


{ 

/* local variables */ 

ControlHandle theItemHandle ; 

Rect scratch ; 
GrafPtr entryGrafPort ; 


/* get a handle to the button */ 
GetDItem ( ourDialog, snapshotItem, &scratch, &theItemHandle, &scratch) 


=e 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* save a pointer to the grafPort */ 
GetPort (4entryGrafPort) ; 


/* this lets me take some snapshots */ 
/* has no effect unless you have a desk accessory named Camera */ 


OpenDeskAcc ("\007\000Camera") ; 


/* restore the grafPort */ 
SetPort (entryGrafPort) ; 


/* unhilite the button */ 
HiliteControl (theItemHandle, activeHS ) ; 


/* deal with a click of the mushroomItem button */ 
void doMushroomItem () 


{ 


/* local constants */ 


#define cyclesDesired 4 

#define delayTicks 30 
/* local variables */ 

Rect scratch ; 

short cycleCounter ; 


ControlHandle itemHandleOne ; 
ControlHandle itemHandleTwo ; 


/* get a handle to the button */ 
GetDItem ( ourDialog, mushroomItem, &scratch, &itemHandleOne, &scratch) 


=e 


/* hilite the button */ 
HiliteControl (itemHandleOne, hilitedHS ) ; 


/* get a handle to the bumperStickersItem button */ 
GetDItem ( ourDialog, bumperStickersItem, &scratch, 
&itemHandleTwo, &scratch) ; 


/* run several fade cycles on the bumperStickersItem button */ 
for ( cycleCounter = 0; cycleCounter < cyclesDesired; cycleCounter++) 


{ 
/* fade out */ 
HiliteControl (itemHandleTwo, hilitedHS ) ; 


/* wait a while */ 
Delay (delayTicks, &scratch) ; 


/* back into view */ 
HiliteControl (itemHandleTwo, activeHS ) ; 


/* wait a while */ 
Delay (delayTicks, &scratch) ; 
} 


/* unhilite the button */ 
HiliteControl (itemHandleOne, activeHS ) ; 
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How many 
@ programmers does 
it take to maintain a 


/* remove local constants */ 








tundef cyclesDesired MAKE dependency file? 
#undef delayTicks 
} 

(clocemasaaste te aetna Soe Retain sen Y NONE! /f you 


@ use VersiMAKE™ 


/* deal with a click of the openItem button */ 


void doOpenItem () 


{ 


/* local variables */ 


Rect scratch ; 
ControlHandle theItemHandle ; 
DialogTHndl theDLOGHandle ; 


SFReply dummyReply ; 


/* get a handle to the button */ 
GetDItem ( ourDialog, openItem, &scratch, &theItemHandle, &scratch) ; 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* run the standard file open dialog */ 
theDLOGHandle = (DialogTHndl) GetResource ('DLOG', getDlgID) ; 


VersiMAKE™ is a full-featured 
MAKE utility that includes: 


M@ Dependency Generation 


Derives your system’s dependencies, 
through analysis of its C and MASM 
source files. Say goodbye to manual 
maintenance of MAKE dependency files! 


@ Wild Card File Name Matching 


Analyzes an entire collection of source 
files with a single statement. 


@ Nested Include File 


SFGetFile (figureCenteredRectTLC (&(**theDLOGHandle) .boundsRect), 


Handles standard nd MA aa 
nil, nil, allTypes, nil, nil, &dummyReply ) ; : Ca SM “include 


conventions, and the INCLUDE environ- 


ment variable. 
/* unhilite the button */ @ Powerful Macro Facilities 
HiliteControl (theItemHandle, activeHS ) ; 


"5 Built-in macros, user-defined macros, 
and environment variables. 

@ Analytical Reports 

Shows the entire Include file hierarchy 
for each source file analyzed, and all of 
the parent source files for each Include file. 


| /tan------------------------------ Gtavehsites -— */ 
/* deal with a click of the saveAsItem button */ 


void doSaveAsItem () 


{ 
/* local variables */ 


Rect scratch ; 
ControlHandle theItemHandle ; 
DialogTHndl theDLOGHandle ; 


How many 
@ programmers does 
it take to trace a 
symbol thru your system? 


SFReply dummyReply ; 


/* get a handle to the button */ 
GetDItem ( ourDialog, saveAsItem, &scratch, &theItemHandle, &scratch) ; 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* run the standard. file open dialog */ 

theDLOGHandle = (DialogTHndl) GetResource ('DLOG', putDIlgID) ; 

SFPutFile (figureCenteredRectTLC (& (**theDLOGHandle) .boundsRect), 
"\015Save file as:", "\021Current File Name", 


nil, &dummyReply ) ; 


ONE! /f you 
@ use VersiCREF™ 





VersiCREF™ is a unique utility 
that creates a Master Cross- 
Reference of your entire system. 


@ Multi-Lingual 

Handles C, assembler, or both. 

@ Flexible 

File names with line numbers, or file 


names alone. Global and local symbols, 
or globals alone. 


/* unhilite the button */ 

HiliteControl (theItemHandle, activeHS ) ; 

} 
FR NEAL IIE GoP Li pl teen ete ererenes */ 
/* deal with a click of the flipItem button */ 


void doFlipItem () 


{ 


/* local constants: */ 








#define numButtons 9 @ Powerful 
#define cyclesDesired 4 ‘ a 
ora delayTicks 4% Easily handles systems containing 100 
source files or more. 
/* local variables */ 
static short flipList [numButtons] = ™ 
{ hupCoupleItem, mouthOpensItem, vO. $125 
trashItem, melancholyItem, VersiCREF $75 
Both $150 
a Cea (Outside U.S., add $5 for shipping 
and handling) 
duplicateItem, orwelllItem, Yf Y 
bumperStickersItem Uy 800-334-4096 
ae _ UY (In NJ, 609-871-0202) 
scratch ; 
ControlHandle theItemHandle ; MC/VISA/AMEX accepted 
short cycleCounter ; 
hort index ; 
coksclkentie. caapuiadinndies” SUMMIT INFORMATION 
SYSTEMS, INC. 
73 East Lane, Willingboro, NJ 08046 


f { page 
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TRUE 


MULTITASKING 


With 
MultiDos Pius 
‘‘multitasking for the IBM-PC.’ 


Ideal for developing applications 
in process control, data acquisi- 
tion, communications, and other 
areas. Check these features which 
make MultiDos Pius an unbeat- 
able value. 


e Run up to 32 programs concur- 
rently. 

e Your software continues to run 
under DOS. No need to learn a 
new operating system. 

e Use the compilers you already 
have. Supports software written in 
most languages. 

e Operator commands to load/run 
programs, change priority, check 
program status, abort/suspend / 
resume programs. 

¢ Programmatic interface via INT 15H 
for the following. 


* Intertask message communica- 

tion. Send/receive/check mes- 

sage present on 64 message 

queues. 

Task control by means of 

semaphores. Get/release/check 

semaphores. 

* Change priority-256 priority 

levels. 

Suspend task for specified 

interval. 

Spawn and terminate external 

and internal tasks. 

Disable/enable multitasking. 

and more! 

e Independent foreground /back- 
ground displays. 

e Access to DOS while applications 

are running. 


Hardware/Software Requirements 
IBM PC/XT/AT or true clone. Enough 
memory to hold MultiDos Pius (48 
KB) and all your application programs. 
Also may need 4 or 16 KB memory 
for ‘hidden screens’ for each active 
task. MS-DOS (or PC-DOS) 2.0 or 
later operating system. 


only: $24.95 OR 
$99.95 


with source code 







Outside USA add $5.00 shipping and handling. 


Visa and Mastercard orders only call 
toll-free: 1-800-872-4566, ext. 350., or 
send check or money order to: 


NANOSOFT 


13 Westfield Rd, Natick, MA 01760 
MA orders add 5% sales tax. 
CIRCLE NO. 139 ON READER SERVICE CARD 
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Listing One (Listing continued, text begins on page 90.) 





/* get a handle to the button */ 
GetDItem ( ourDialog, flipItem, &scratch, &theItemHandle, &scratch) ; 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* run several animation cycles on a group of content-changing buttons 
*/ 
for ( cycleCounter = 0; cycleCounter < cyclesDesired; cycleCounter++) 


/* hilite all the buttons in the group */ 
for (index = 0 ; index < numButtons ; indext++t) 
{ 
GetDItem ( ourDialog, flipList[index], &scratch, 
&tempItemHandle, &scratch) ; 
HiliteControl (tempItemHandle, hilitedHS ) ; 
} 


/* wait a while */ 
Delay (delayTicks, &scratch) ; 


/* unhilite all the buttons in the group */ 
for (index = 0 ; index < numButtons ; index++) 


{ 

GetDItem ( ourDialog, flipList[index], &scratch, 
&tempItemHandle, &scratch) ; 

HiliteControl (tempItemHandle, activeHS ) ; 

} 


/* wait a while */ 
Delay (delayTicks, &scratch) ; 
} 


/* unhilite the button */ 
HiliteControl (theItemHandle, activeHS ) ; 


/* remove local constants */ 
#undef numButtons 


#undef cyclesDesired 
#undef delayTicks 


/* deal with a click of the someOffItem button */ 


void doSomeOffItem (theOffList, listSize) 
short theOffList[] ; 
short listSize ; 


{ 

/* local variables */ 

short index ; 
Rect scratch ; 
ControlHandle theItemHandle ; 
ControlHandle tempItemHandle ; 


/* get a handle to the button */ 
GetDItem ( ourDialog, someOffItem, &scratch, &theItemHandle, &scratch) ; 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* for each item in the list */ 
for (index = 0 ; index < listSize ; indext++) 
{ 
/* get a handle to the item */ 
GetDIitem ( ourDialog, theOffList[index], &scratch, 
&tempItemHandle, &scratch) ; 


/* inactivate the item */ 
HiliteControl (tempItemHandle, inactiveHS ) ; 
} 


/* unhilite the someOffItem button */ 
HiliteControl (theItemHandle, activeHS ) ; 


/* deal with a hit of the someOnItem button */ 


void doSomeOnItem (theOnList, listSize) 
short theOnList[] ; 
short listSize ; 


{ 

/* local variables */ 

short index ; 
Rect scratch ; 
ControlHandle theItemHandle ; 
ControlHandle tempItemHandle ; 
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/* get a handle to the button */ 
GetDItem ( ourDialog, someOnItem, &scratch, &theItemHandle, &scratch) ; 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* for each item in the list */ 


for (index = 0 ; index < listSize ; index++) 
{ 
/* get a handle to the item */ 
GetDItem ( ourDialog, theOnList[index], &scratch, 
&tempItemHandle, &scratch) ; 


/* activate the item */ 
HiliteControl (tempItemHandle, activeHS ) ; 
} 


/* unhilite the someOnItem button */ 
HiliteControl (theItemHandle, activeHS ) ; 


/* deal with a hit on the copyrightItem button */ 
void doCopyrightItem () 


{ 


/* local variables */ 


Rect scratch ; 
ControlHandle theItemHandle ; 

DialogPtr copyrightDlog ; 
Point tempPoint ; 


/* get a handle to the button */ 
GetDItem ( ourDialog, copyrightItem, &scratch, &theItemHandle, &scratch) 


/* hilite the button */ 
HiliteControl (theItemHandle, hilitedHS ) ; 


/* pull in the copyright notice modal dialog */ 
copyrightDlog = GetNewDialog (copyrightDlogID, storeInHeap, inFront) ; 


/* center it on the screen */ 
MoveWindow ( copyrightDlog, 
(tempPoint = figureCenteredRect TLC 
(& (*copyrightDlog) .portRect)).h, 
tempPoint.v, inFront ) ; 


/* show the copyright notice */ 
ShowWindow (copyrightDlog ) ; 


/* wait until the user clicks the mouse in the dialog */ 
ModalDialog (noFilterProcedure, &scratch) ; 


/* get rid of the dialog */ 
DisposDialog (copyrightDlog) ; 


/* unhilite the button */ 
HiliteControl (theItemHandle, activeHS ) ; 


ee FigureCenterediectTic: —<——————— eee */ 


/* given a rectangle, returns the top left corer position that will 
center the rectangle inside screen area that's below the menu bar */ 


Point figureCenteredRectTLC (theRect) 


Rect *theRect ; 


{ 
/* local variable */ 
Point theResult ; 


/* figure the vertical position */ 
theResult.v = menuBarHeight + ((screenHeight - menuBarHeight) - 
(theRect— 
>bottom - theRect->top) ) / 2 ; 


/* figure the horizontal position */ 
theResult.h = ( screenWidth - (theRect->right - theRect->left) ) / 


(continued on next page) 
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Courseware Applications, Inc. 


Finally...a product that lets you 
create complex graphics displays 
for your applications, but saves you 
the tedious task of programming. 


That's right...just draw the picture 
on the screen using the mouse or the 
keyboard. When you're done, 
Drawbridge automatically writes a 
program to recreate the graphic. 
You copy the code into your appli- 
cation and that's it! 


Drawbridge is an interac- 
tive graphics editor that 
greatly increases produc- 
tivity when creating so- 
phisticated graphics dis- 
plays. 


Create fantastic graphics 
using features such as lines, 
ovals, arcs, polygons, com- 
plex fill patterns, color, and 
text fonts. 


The best way for you to 
evaluate this powerful new 
tool is to try it for yourself. 
The program comes with a 
30-day money back guaran- 
tee. 


To order, or for more information, 
call: 


(217)359-1878 


COURSEWARE APPLICATIONS, INC. 
475 Devonshire Drive 
Champaign, IL 61820 


Drawbridge is available for the IBM PC and close com- 
patibles for $129. The current version generates C language 
function calls for the MetaWINDOW™ graphics library. 
Most popular graphics cards are supported. 
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TO THE MACS 





Listing One (Listing continued, text begins on page 90.) 


/* done, so return the point */ 


return (theResult) ; 
} 
e 
Listing Two 
| Soe ee eS ene mS lemme mm file information ----------------------------- wy 
/* 
custom controls demo.h 
private definitions for custom controls demo.c 
edited and compiled with Lightspeed C 2.13 
©1987 by Stan Krute -- all rights reserved 
timestamp: 5:56 pm PST November 16, 1987 
spacestamp: 18617 Camp Creek Road Hornbrook, California 96044 
this file looks good in 9 point Courier, LSC tabs set to 3 
SF 
[ & ene enn - - - - - -- - - -- - - - - - = - = - = -- CONStANtS --H- Hn nn nn nn nn nn nn = wf 
/* booleans */ 
#define true 1 
#define false 0 
/* parameters */ 
#define humungousBlock Ox8FFFFFFF 
#define noResumeProcedure 0 
#define dontStop 0 
#define nil 0 
#define allTypes -1 
/* control stuff */ 
#define activeHS 0 /* three hilite states */ 
#define inactiveHS 255 
#define hilitedHS 10 
/* menu stuff */ 
#define StdMBarHeight 20 
#define titleMenulID 1 
#define append 0 
/**dialog stuff */ 
#define storeInHeap 0 
#define inFront -1 
#define ourDialogID 1 
#define copyrightDlogID 210 
#define noFilterProcedure 0 
#define quitItem 1 
#define orwellItem 2 
#define snapshotItem 3 
#define bumperStickersItem 4 
#define mushroomItem 5 
#define hupCoupleItem 6 
#define openitem 7 
#define ronitem 8 
#define saveAsItem 9 
#define duplicateItem 10 
#define woozyItem 21 
#define trashItem 12 
#define flipItem 13 
#define mouthOpensItem 14 
#define copyItem 15 
tdefine melancholyItem 16 
#define pinheadItem 17 
#define someOffItem 18 
#define someOnItem 19 
#define eeekShrinkItem 20 


End Listing One 
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oe 
#define copyrightItem 21 
fencers EEL toe definitions --92---+-- eee af 
typedef short boolean; 
han mmanlidieadaaanma function. prototypes er eere */ 


void main (void) ; 

void initializeManagers (void) ; 

void studyAndSetEnvironment (void) ; 

void getThatDialogCookin (void) ; 

void dealWithDialogItem (int thelItem) ; 

void doSnapshotItem (void) ; 

void doOrwellItem (void) ; 

void doMushroomItem (void) ; 

void doOpenItem (void) ; 

void doSaveAsItem (void) ; 

void doFlipItem (void) ; 

void doSomeOffItem (short theOffList[], short listSize); 
void doSomeOnItem (short theOnList[{], short listSize) ; 
void doCopyrightItem (void) ; 

Point figureCenteredRectTLC (Rect *theRect) ; 


| == ee global variables -—---<------------------------- a/ 
boolean finished ; /* indicates when the 
program should end */ 

DialogPtr ourDialog ; /* points to our main dialog */ 
int menuBarHeight ; /* know your environment... */ 
int screenHeight ; 

int scceenWidth ; 

Rect screenRect ; 














You Can Help Save Lives ... 


The doctors at St. Jude Children’s Research Hos- 
pital caught Shane’s cancer in time. To save his life 
they removed his leg. Despite his loss, Shane con- 
siders himself lucky . . . he had St. Jude on his side. 

Every year, St. Jude is on the side of thousands 
of children just like Shane. Almost 60 percent of 
these children will survive, but many, too, will die. 
To hospital founder Danny Thomas and the entire 
St. Jude staff this is unacceptable. St. Jude’s work 
will not be finished until all childhood cancer is 
nothing more than a bad m memory. 


Just look how far +. 9 Like Shane's 


Shane has come in three 
short years. St. Jude has 
given him another 
chance at life and peo- 
ple like yourself helped 
to make it possible. 
Fighting cancer is a 
painful ordeal, and 
| there are no certainties 
that Shane will not 
relapse. But Shane is 
alive and healthy and 
doing the things boys 
his age like to do. And 


as lo St. Jude h 
ie i ES . ae a fe For more information on how you can heip, please | 


public, there will be write for your free brochure, or call 1-800-238-9100. 


hope for children like me st. Jude Children’s Research Hospital 
Shane a: 505 North Parkway, Memphis, TN 38105 | 









During treatment 





















Today, Shane is healthy and active. 
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Get Your 
Disks Moving! 


NT lead 
Ka 





Fast -increase your effective pro- 
gram speed up :o 10 times! Data 
that has been read from your hard 
disk is retained in your computer's 
fast internal memory for super 
fast access the next time you need 
it. 
Now Faster! - use the new Deferred 


Write option to cache disk Writes, 
for even faster processing. 


Safe - use the Write Through 
option for maximum safety from 
system failures and power glitches. 


Smart - Hot LRU algorithm identi- 
fies and prioritizes sector chains 
and single sector accesses; ef- 
ficient hashing algorithm insures 
instant access to cached data. 





Adaptable - use up to 15 mega- 
bytes of extended or expanded 
memory, or up to half a megabyte 
of standard memory. Cache up to 
24 hard disks using standard BIOS 
interface or software driver. 





Easy - installs with one statement; 
requires no modification of your 
existing programs; transparent to 
all normal programs. 


Compatible - even with AutoCAD, 
removable media drives, disk parti- 
tioning software. . . 





Includes - Vkette diskette accel- 
erator, Vscreen mono accelera- 
tor, Vkey keyboard accelerator. 


e905 Stereerae 
GOLDEN BOW SYSTEMS 


2870 Fifth Avenue 
Suite 201 
San Diego, CA 92103 


619/298-9349 


Vcache operates with DOS systems. Vcache isa 
trademark of Golden Bow Systems. AutoCAD isa 
trademark of Autodesk Inc. DOS is a trademark of 
Microsoft Corp. and International Business 
Machines Corp. 
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Programmer s 
Power Pack 





ow you can reach 100,000 





programmers, consultants, 
and systems integrators with your 
postcard ad. The Programmer's Power 
Pack card deck targets this elite audi- 
ence, including subscribers to Dr 
Dobb's Journal of Software Tools, tor 


only a little over a penny a contact! 


The Programmer's Power Pack 
Card Deck 


Next Mailing Date: April 10, 1988 
Reservation Closing: March 13, 1988 


For advertising rates, card specifications, and 
to reserve your space, contact: 


Ann Roskey 
Northeast Account Manager 
415-366-3600 


Stephen Nestel 
National Account Manager 
415-521-4133 
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Listing One (Listing continued, text begins on page 108.) 


Listing One. Example for declaring various objects that are 
variations of stack structures 
PROGRAM Test Objects (input, output) ; 


{ Simple example for objects using TML Pascal running on a Mac Plus } 


TYPE RealStackReg 
IntStackReg 


ARRAY [1..4] OF real; 
ARRAY [1..4] OF integer; 


{ define common stack-related variables and routines } 
TStack = OBJECT 

height : integer; 

ErrorFlag : boolean; 

PROCEDURE TStack.IStack; 

PROCEDURE TStack.Inc(VAR i : integer); 

PROCEDURE TStack.Dec(VAR i : integer); 
END; 


{ define a 4-register real-typed stack } 
TRealStack = OBJECT (TStack) 

Regs : RealStackReg; 

PROCEDURE Push(Item : real); 

FUNCTION Pop : real; 

PROCEDURE Add; 
END; ” 


{ define a 4-register real-typed stack with automatic 
LastX register } 
THPStack = OBJECT (TRealStack) 
LastX : real; 
PROCEDURE Add; OVERRIDE; 
END; 


{ define a 4-register integer-typed stack } 
TIntStack = OBJECT (TStack) 

Regs : IntStackReg; 

PROCEDURE Push(Item : integer); 

FUNCTION Pop : integer; 

PROCEDURE Add; 
END; 


PROCEDURE TStack.IStack; 


{ Initialize TStack objects by setting the Stack height to zero } 
BEGIN 


height := 0 
END? «{ Stack.istack } 
PROCEDURE TStack.Inc(VAR i : integer); 


BEGIN 
+ ce 1 = 1g 
END; 
PROCEDURE TStack.Dec(VAR i : integer); 
BEGIN 
41 -s= 1 = 15 
END; 


PROCEDURE TRealStack.Push(Item : real); 


VAR i: integer; 


BEGIN 
Inc (height) ; 
FOR i := 4 DOWNTO 2 DO 
Regs[i] := Regs[i-1]; 
Regs({1] := Item; 


END; { RealStack.Push } 
FUNCTION TRealStack.Pop : real; 


VAR i : integer; 
BEGIN 
IF height > O THEN BEGIN 
Pop := Regs([1]; 
FOR i := 1 TO 3 DO 
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Regs[i] := Regs[i+l); 
Dec (height) ; 
ErrorFlag := FALSE; 

END 

ELSE BEGIN 
Pop := 1.0E+30; 
ErrorFlag := TRUE 

END; 


END; { TRealStack.Pop } 
PROCEDURE TRealStack.Add; 


VAR i : integer; 


BEGIN 
Regs[1] := Regs[1] + Regs[2]; 
FOR i := 2 TO 3 DO 
Regs[i] := Regs[itl]; 
END; { TRealStack.Add } 


PROCEDURE THPStack.Add; 
VAR i : integer; 


BEGIN 
LastX := Regs[1]; 
Regs[{1] := Regs[{1] + Regs([2]; 
FOR i := 2 TO 3 DO 
Regs[i] := Regs[it+l]; 
END; { THPStack.Add } 


PROCEDURE TIntStack.Push(Item : integer); 


VAR i : integer; 


BEGIN 
Inc (height) ; 
FOR i := 4 DOWNTO 2 DO 
Regs[(i] := Regs[i-1]; 


Regs{1] := Item; 
END; { TIntStack.Push } 


FUNCTION TIntStack.Pop : integer; 


VAR i : integer; 


BEGIN 
IF height > O THEN BEGIN 
Pop := Regs(1]; 
FOR i := 1 TO 3 DO 
Regs[i] := Regs[i+l]; 
Dec (height); 
ErrorFlag := FALSE 


END 
ELSE BEGIN 
Pop := -32767; 
ErrorFlag := TRUE 
END; 


END; { TIntStack.Pop } 
PROCEDURE TIntStack.Add; 


VAR i : integer; 


BEGIN 
Regs[1] := Regs[{1l] + Regs[2]; 
FOR.i.s= 2 TO 3° DO 
Regs[i] := Regs[i+1]; 


END; { TIntStack.Add } 


{ ---------------- declarations of variables 


VAR RealStack : TRealStack; 
IntStack -: -TintStack;: 
{ HPStack : THPStack; } 
X : real; 
I : integer; 
ch <-char: 
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MODULA-2 


No other language is more advanced or 


better suited to the new PC environ- 


ments. We make reasonably priced tools 


for it. And we send full, free copies 


of our manuals to every caller. 


* Repertoire ®; The premier general-purpose 


M2 toolkit. Release 1.5 includes fast screen 
design/display system for virtual windows 
that scroll horizontally and vertically, plus 
single and multi-line input fields, context 
sensitive help, menus, forms, etc. Also 
includes sophisticated list-oriented DBMS 
with variable-length records, garbage 
collection, and damaged file recovery. 
Stores anything: bitmaps, text, linked lists, 
binary records, etc. Includes full source 
(over 600K), hundreds of low- 

level routines, and 300 pp. manual. 89 


EmsStorage ™: Advanced, high-level 
memory manager that detects and uses LIM 
Expanded Memory if present, or DOS 
memory if not; lets users conserve scarce 
DOS memory for other programs, and lets 
larger programs run under Logitech's 
debuggers. Provides automatic garbage 
collection and MS-Windows-like interface 
(lock/unlock functions) for porting g 

programs to MS Windows. ....... Ay 


Repertoire®/ Btrieve® Toolkit: Novell/ 
SoftCraft’s Btrieve file manager is 
emerging as the standard for large business 
applications. But don’t start with the bare 
bones—R/BT is a massive support system, 
including a customizable prototype 
application, that saves many months of 
work in producing a finished Btrieve 


application. 

Includes full source. «00.56 sieves | 49 
ModBase: A full B+Tree DBMS that uses a 
file format compatible with Ashton-Tate’s 
dBase III. Provides indexing and file 
manipulation routines for use independent 
of dBase; billions of records per file.g 
Includes fall 40urct. 0.0065 eewslea v4 89 


Graphix: The Modula-2 interface to 
MetaWINDOW, the fast professional 
graphics system PCTJ named 7/85 Product 
of the Month. Supports multiple fonts, over 
30 display adapters, and hundreds of modes. 
Includes full MetaWINDOW 


PRCRAMG asses see rs eRe Oe $ ] 49 


Macro2: A C-like macro preprocessor for 
Modula-2; provides inline expansion of 
functions, include files, conditional 
compilation, etc. Includes full 

SOUTCE HOKE! sti oes ene 65 oe F885 $89 


All libraries available as DOS LINK- 


compatible object modules, useable by 
other MS-Standard languages. All 


available exclusively from PMI; dealer 


inquiries welcome, welcome. 


ee ge ug. fe ya ga Re aS MC 
r | | "| | AMEX/COD/PO 


(503) 777-8844 


4536 SE 50th BIX: pmi 
Portland, OR 97206 
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STRUCTURED PROGRAMMING 


Listing One (Listing continued, text begins on page 108.) 













BEGIN 
NEW (RealStack) ; 
NEW (Int Stack) ; 
NEW (HPStack) ; 
{ exercise real-type stack } 
RealStack.IStack; 
RealStack.Push(1.0); 
RealStack.Push(2.0); 
RealStack.Push (3.0); 
RealStack.Push (4.0); 
RealStack.Add; 
X := RealStack.Pop; 
WRITELN('X = ',X); WRITELN; 
{ use HPStack } 
HPStack.IStack; 
HPStack.Push(0.0); 
HPStack.Push(0.0); 
HPStack.Push(3.0); 
HPStack.Push (4.0); 
INHERITED HPStack.Add; 
X := HPStack.Pop; 
WRITELN('X = ',X); 
WRITELN ('LastX = ', HPStack.LastxX); 
WRITELN; 
{ exercise integer-type stack } 




























IntStack. 
IntStack 
IntStack 
IntStack 
IntStack 
IntStack 


IStack; 


-Push(1); 
-Push(2); 
-Push (3); 
-Push (4); 
- Add; 





I 
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:= IntStack.Pop; 


WRITELN('I = ',1I); WRITELN; 
readln (ch); 
END. 


Macintosh System Software 
Product Manager 


Apple products have a reputation for innovation, 
the ability to communicate clearly and graphically, 
and versatility. So the people we select as Apple 
Product Managers should display the same virtues. 

If you have experience in microcomputer 
product management, why not become a part of the 
company that launched the industry and continues 
to shape its direction. Look into this opportunity 
today with Apple: 

You will work closely with engineering and 
others to drive product strategy for new releases of 
Macintosh system software. In-depth knowledge of 
Macintosh software development and familiarity 
with traditional operating system concepts as well 
as the major operating systems is required. You 
must also have a good feel for related business and 
marketing issues, management skills and good oral 
and written communication skills. BSCS or equiva- 
lent preferred. 


To apply, please send your resume to APPLE 
COMPUTER, INC., Human Resources, 20525 


Mariani Ave., Dept. TM, MS9-C, Cuper- 
tino, CA 95014. Principals only, please. & 
We are an equal opportunity employer. ® 





Fs 
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Imagine! Developing and testing ROM software 
from your terminal in a matter of minutes. 
No more blasting ROMs! 


ROMulator™ Features: 

e Emulates standard (EDEC) 24 and 28 pin ROMs 

e 8, 16, and 32 bit word modes 

e Daisy chain modules for up to 8 unique ROMs 

¢ Non-volatile models retain software during power-down 
e As little as $325.00 per ROM 

¢ Models available up to 1 Mega-bit 


ASK US ABOUT FASTER ROMS AND CUSTOMIZING 
CABLES FOR OTHER ROM TYPES. 


Griamimimag 
Eongimme 
fgpe 614/882-6366 


VISA and MasterCard Accepted aisvanoaen call: 


Dealer Inquiries Welcome 


Grammar Engine, Inc. 
1021 Tipton Court 
Westerville, OH 43081 
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UNLEASH YOUR 80386! 





Your 80386-based PC runs at least 
twice as fast as your old AT. This is good, 
but not great. The products described 
below will unleash the true potential of 
your 80386, giving you 4 to 16 times the 
power of your old AT. These new Micro- 
Way products include a family of 80386 
native code compilers and the mW1 167 
numeric coprocessor. 

Examples of the increases in capacity 
and performance include: 
e Programs compiled with MicroWay 


NDP Fortran-386 execute 2 to 8 times 
faster than those compiled with existing 
16-bit Fortrans. NDP Fortran-386 can 
also address up to 4 gigabytes of 
memory instead of the standard 640 
kbytes. MicroWay’s NDP compilers 
and the programs they generate run on 
MS-DOS or Unix V. 

e NDP Fortran-386 generates code for 
the 80287, 80387 or MicroWay’s 
mW1167. The mW1167 has a floating 
point throughput exceeding 2.5 mega- 


mW1167 Numeric 


al Ee a Fis = 


Pesit it iter 


MicroWay 80386 Compilers 


NDP Fortran-386 and NDP C-386 are globally 
optimizing 80386 native code compilers that 
support a number of Numeric Data Processors, 
including the 80287, 80387 and mW1 167. They 
generate mainframe quality optimized code and 
are syntactically and operationally compatible to 
the Berkeley 4.2 Unix f77 and PCC compilers. 
MS-DOS specific extensions have been added 
where necessary to make it easy to port pro- 
grams written with Microsoft C or Fortran and 
R/M Fortran. 

The compilers are presently available in two 
formats: Microport Unix 5.3 or MS-DOS as ex- 
tended by the Phar Lap Tools. MicroWay will port 
them to other 80386 operating systems such as 
OS/2 as the need arises and as 80386 versions 
become available. 

The key to addressing more than 640 kbytes 
is the use of 32-bit integers to address arrays. 
NDP Fortran-386 generates 32-bit code which 
executes 3 to 8 times faster than the current 
generation of 16-bit compilers. There are three 
elements each of which contributes a factor of 2 
to this speed increase: very efficient use of 
80386 registers to store 32-bit entities, the use of 
inline 32-bit arithmetic instead of library calls, 
and a doubling in the effective utilization of the 
system data bus. 

An example of the benefit of excellent code is a 
32-bit matrix multiply. In this benchmark an NDP 
Fortran-386 program is run against the same 
program compiled with a 16-bit Fortran. Both 
programs were run on the same 80386 system. 
However, the 32-bit code ran 7.5 times faster 
than the 16-bit code, and 58.5 times faster than 
the 16-bit code executing on an IBM PC. 

NDP FORTRAN-386 ™ 
I a vn nncittb aden vecesascens $595 


Micro 
Way 








MicroWay Numerics 


The mW1167™ is a MicroWay designed high 
speed numeric coprocessor that works with the 
80386. It plugs into a 121 pin “Weitek” socket 
thatis actually a super set of the 80387. This soc- 
ket is available on a number of motherboards 
and accelerators including the AT&T 6386, 
Tandy 4000 and MicroWay Number Smasher 
386 (Jan. ’88). It combines the 64-bit Weitek 
1163/64 floating point multiplier/adder with a 
Weitek/Intel designed “glue chip”. The 
mW1167™ runs at 3.6 MegaWhetstones (com- 
piled with NDP Fortran-386) which is a factor of 
16 faster than an AT and 3 to 5 times faster than 
$1495 


Monoputer™ - The INMOS T800-20 Trans- 
puter is a 32-bit computer on a chip that features 
a built-in floating point coprocessor. The T800 
can be used to build arbitrarily large parallel pro- 
cessing machines. The Monoputer comes with 
either the 20 MHz T800 or the T414 (a T800 
without the NDP) and includes 2 megabytes of 
processor memory. Four or more Transputers 
can be easily linked together to form a Quad- 
puter. A single T800 is comparable in speed with 
an mW1167-equipped 80386. The compilers to 
drive one or more Monoputers include Occam, 
C, Fortran, Pascal and Prolog. 


Monoputer T414-20' .............. $1495 
Monoputer T800-20' ............+. $1995 
Biputer™ T800/T4142.............. $4995 
Quadputer™ 7414-202 ............. $6995 
‘Includes Occam 2iIncludes TDS 

80287 ACCELERATORS 
SET TO aks cee we a cb aed dees $450 
Se VOLS 5 cca Weve es be 8 rermweens $550 
PBT TENORS TE. «cca necccsscvcnaave $629 


flops, which is 4 to 5 times the through- 
put of an 80387 and is comparable to 
the speed achieved by the VAX 8600. 
Equally important, whichever Micro- 
Way product you choose, you can be 
assured of the same excellent pre- and 
post-sales support that has made Micro- 
Way the world leader in PC numerics 
and high performance PC upgrades. 
For more information, please call the 
Technical Support Department at 
617-746-7341 


MicroWay* 
80386 Support 


80386 Multi-User Solutions 


AT8™ -This intelligent serial controller is designed 
to handle 8 users (16 with two boards) in a Xenix 
or Unix environment with as little as 3% degrada- 
tion in speed. Ithas been tested and approved by 
Compaag, Intel, NCR, Zenith, and the Department 
of Defense for use in high performance 80286 
and 80386 Xenix or Unix based multi-user 
systems 


MicroPort Unix 5.3 is a port of the new Unix 5.3 
to the 80386. MicroWay NDP-386 compilers 
currently run on this version of UNIX. 

MicroPort Unix 5.3 ............. from $399 


PC-MOS-386™ is an 80386 operating environ 
ment that tums an AT with an AT8 into an MS- 
DOS multi-user system. The system makes it 
possible to run applications such as Lotus 1-2-3 
on terminals. The operating system also has a 
Phar Lap compatibility mode that runs programs 
developed with the Phar Lap versions of Micro- 
Way S COMDENS ii. seo cee menaes s from $199 


Phar Lap™ created the first tools that make it 
possible to develop 80386 applications which 
run under MS-DOS yet take advantage of the full 
power of the 80386. These include an 80386 
monitor/loader that runs the 80386 in protected 
linear address mode, an assembler, linker and 
debugger. These tools are required for the MS- 
DOS version of the MicroWay NDP Compilers. 


Phat Lan TOOK cc criewesrecvavece $399 
MATH COPROCESSORS 

80387-16 16 MZ. scien eeecesecccs $495 
S0287-10 10 MZ i ccc cetites veces $349 
80287-8 S Mie . ai... beds edi cesek $259 
80287-6 6 MHZ .... cece eee e cc ennes $179 
GOB T-2 6 AES oi es occ diene tens isea8 $154 
BOGT SAL isc ie kc coh ieee evi pen ses $99 


The World Leader in PC Numerics 


P.O. Box 79, Kingston, Mass. 02364 USA (617) 746-7341 
32 High St, Kingston-Upon-Thames, U.K., 01-541-5466 
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PROGRAMMERS 








helps save time, money, and cut frustrations. Compare, evaluate, and find products. 















































e kept microcompu 
elopment tr 








| importan 
ers. 386 Native le L er 
ware. Object-Oriented Programming. V 
ming. or Windowing Environme — 
___yourpacket 


386 Development Tools 








386 Assembler/Linker PC $ 389 
386 Debug - by Phar Lap PC 3.129 
386/DOS Extender PC $ 919 
DESQview PS/2 PC $ 109 
F77L-EM - by Lahey MS Call 
High C - by Metaware PC Call 
OS/286 & 386 by Al Architects PC Call 
Al Languages 

APT - Active Prolog Tutor - build 

applications interactively PC $ 49 


ARITY Prolog - full, 4 Meg 
Interpreter - debug, C, ASM PC $ 229 
COMPILER/Interpreter-EXE PC $ 569 
Cogent Prolog Compiler MS $ 179 
MicroProlog Prof. Comp./Interp. MS $ 439 
PC Scheme LISP - by TI PU-~3. 84 


Star Sapphire MS $ 429 
TransLISP - learn fast MS $ 79 
TransLISP PLUS MS $ 149 


TURBO PROLOG by Borland PC $ 69 
Others: IQ LISP ($239), IQC LISP ($269) 


BAS_C - economy MS $ 179 
BAS_PAS - economy MS $ 135 
Basic Development Tools PC $ 89 
db/Lib MS $ 119 
Exim Toolkit - full POS: 45 
Finally - by Komputerwerks PC $ 85 
Inside Track PC $ 49 
Mach 2 by MicroHelp PC. 3. 55 
NetWorks by Exim POS 89 
QBase - screens MS $ 79 
QuickBASIC PC $ 69 
Quick Pak-by Crescent Software PC $ 59 
Quick-Tools by BC Associates PC $ 109 
Stay-Res PC 3 - 59 
True Basic PGS 19 
Turbo BASIC - by Borland PC $ 69 
Turbo BASIC Database Toolbox MS $ 69 
Windows/386 by Microsoft-multitask 
standard DOS applications in separate 
640K segments and access expanded 
memory. Toggle, run simultaneously, 
or foreground only. PC $ 149 


Alsys ADA - DoD certified, version 3 
for AT. Optimizing Runtime Executive, 
Multi-Library environment, informative 
error messages. PC, List: 32095 
Note: All prices subject to change without notice. Mention this ad. Some prices 


are specials. Ask about COD and POs. Formats: 3” laptop now available. plus 
200 others. UPS surface shipping add $3/item. 


INNOVATIVE DEVELOPERS! 


* Request a FREE “Innovative Software Tech- 
nology” Packet. Compare key products in areas 
like Translators, Cross Compilers, Prototyping, 
386 Native Mode Development, Object-Oriented 
Programming, and more. 


* Get a FREE “Screen-Oriented C Libraries” Demo 
Disk for 3 competing products. 


* Consider how the products at the right can help 
you program creatively. Call one of our Tech-Reps 
today. 


RECENT DISCOVERY 


XQL - SQL for Btrieve callable from 
BASIC, C, and Pascal or for interactive 
query. Computed fields, specify sort 
order, manipulate composite records 
from joined files. No royalties. MS $459 


C Language-Compilers 


AZTEC C86 - Commercial PC $499 
C86 PLUS - by CI MS $359 
Datalight Optimum - C MS $ 99 
Lattice C - from Lattice MS $269 
Microsoft C 5.0- Codeview MS $275 
Microsoft Quick C MS $ 69 
Rex - C/86 standalone ROM MS $695 
Turbo C by Borland PC $ 69 


C Libraries-Files : 


BTree by Soft Focus MS $ 69 
CBTREE - Source, noroyalties MS $ 99 
ctree by Faircom - no royalties MS $315 
rtree - report generation PC $239 
dB2C Toolkit V2.0 MS $249 
dbQUERY - ad hoc, SQL-based MS Call 
dbVISTA - Object only MS Call 

Source - Single user MS Call 
dBx - translator MS $299 


C-Screens, Windows, Graphics 


C Worthy Interface Library PC $249 
Curses by Aspen Scientific PC $109 
dBASE Graphics for C PC $ 69 
ESSENTIAL GRAPHICS - fast PC $185. 
FontWINDOW/PLUS PC $229 
GraphiC - new color version PC $279 
Greenleaf Data Windows PC $155 

w/source PC $269 
Terminal Mapping System PC $279 
TurboWINDOW/C - for Turbo C PC $ 79 
View Manager - by Blaise PC $199 
Windows for C - fast PC $149 
Windows for Data - validation PC $239 
Vitamin C - screen I/O PC $159 

VC Screen PC $ 79 
ZView - screen generator MS $129 


AtariST & Amiga 
We carry full lines of Manx & Lattice. 


DBASE Language 
Clipper compiler PC $399 
dBASE II MS $329 


dBase III Plus 


PC $429 





Call for a catalog, literature, and solid value 


800-421-8006 


THE PROGRAMMER’S SHOP “ 


Your complete source for software. services and answers 


5-D Pond Park Road, Hingham, MA 02043 
Mass: 800-442-8070 or 617-740-2510 1 1/94 
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Order before January 31, 1988 and mention 
“DD188” for these SPECIAL PRICES: 


Normal SPECIAL 


$839 
CALL 
$ 79 
$109 
$109 
$299 
$ 75 


List 


$899 
$419 
$ 89 
$124 
$125 
$328 
$ 85 


386/DOS Extender $995 
$495 
$ 99 
$138 
$150 
$350 
$100 


ACTOR - prototype fast 
CLEAR by Clear Software 
FLASHUP with toolkit 
Interactive Easy Flow 
SHOW-PARTNER-FX 
Smalltalk/V 


aI eek 


Instant-C/16M - Addresses up to 16M 
for program and data. Incremental 
compilation makes development 
faster than Turbo C (compile and relink 
XLISP in 4 secs vs 24). 286/386 


only. PC, List: $895 
DBASE Language Cont. 
Clipper compiler PC $399 
dBASE II MS $329 
dBase III Plus PC $429 
dBASE III LANPack PC $649 


DBXL Interpreter by Word Tech PC $109 
FoxBASE+ Dev. - V2.0 MS $289 
Quicksilver by Word Tech PC $499 


DBASE Support 


dAnalyst PC $ 89 
dBase Tools for C Po 265 
dBrief with Brief PC Call 
dBC III by Lattice MS $169 
Documentor - dFlow superset MS $229 
Genifer by Bytel-code generator MS $279 
QuickCode III Plus MS $239 
R&R Report Writer MS $139 
Seek-It - Query-by-example PC $ 79 
Silver Comm Library MS $139 
Tom Rettig’s Library re, 2.79 
UI Programmer - user interfaces PC $249 


DataBase & File Management 


CQL PC $ 359 
DataFlex by Data Access PC $ 899 
DataFlex multiuser PC $1149 
Magic PC PC $ 699 
Paradox - original PC $ 369 
Paradox V2.0 PC $ 469 
Revelation by Cosmos PC. 3.779 


Multilanguage Support 





BTRIEVE ISAM MS $185 
BTRIEVE/N-multiuser MS $455 
GSS Graphics Dev’t Toolkit PC $375 
HALO Development Package MS $389 
Graphics PS $209 
Help/Control - on line help PC $ 99 
Hoops Graphics Library PC $549 
Instant Programmer’s Help MS $ 79 
Informix 4GL-application builder PC $789 
Informix SQL - ANSI standard PC $639 
NET-TOOLS - NET-BIOS PC $129 
Opt Tech Sort - sort, merge MS $ 99 
Norton Guides PC $73 
Panel Plus MS $395 
Pfinish - by Phoenix MS $229 
Report Option - for Xtrieve MS $109 
Screen Sculptor PC $ 89 
SSP/PC - 145+ math routines PC $269 
Synergy - create user interfaces MS $375 
Xtrieve - organize database MS $199 
ZAP Communications- VT 100 PC $ 89 
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EXIM 
TOOLKIT: 









ESSENTIAL BASIC 
PROGRAMMING TOOLS 


A must for all BASIC programmers who use 
Microsoft’s QuickBASIC or IBM’s PC BASIC com- 
pilers, our feature-rich, easy-to-use EXIM ToolKit 
provides dozens of useful routines unavailable in 
BASIC or any other single software library sold 
today! 

Here’s just some of what the EXIM ToolKit 
can do: 

With our Screen Management module, you 
get features like four-way scrolling, windowing and 
data entryMisplay in screen forms. You can also 
write to screen many times faster than with BASIC 
and develop software to copy areas of the screen for 
cut and paste functions. 

The multi-user Data Base Management 
module lets multiple users access the same data 
files across a local area network and still maintain 
data integrity. Users can build, add and delete 
indexes; reformat files and much more. Now BASIC 
users can control data as never before. 

The Network Interface modules make it 
possible for BASIC programs to issue NETBIOS 
commands. 

BASIC limits you to 64K of RAM for strings. 
EXIM ToolKit’s Memory Manager lets you 
access up to 256K additional RAM for strings. 
And, we offer free technical support, 7 days a week. 

Order your EXIM ToolKit today. It’s only 
$99.95, ($199.95 with Network Interface Modules) 
plus $5.00 shipping and handling. (No licensing or 
royalties required.) If within 30 days, you are not 
completely satisfied with the EXIM ToolKit, 
return it to your dealer for a complete refund. 

The EXIM ToolKit is so comprehensive, 
we’re convinced it’s the only BASIC Software 

i "ll ever need. 
Library you'll eve PS: $ 45 
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EXIM SERVICES OF N.A. INC. 
P.O. Box 5417 
Clinton, New Jersey 08809 
(201) 735-7640 
CIRCLE NO. 146 ON READER SERVICE CARD 
























HOURS: 8:30 A.M.-8:00 P.M. E.S.T. 
5-DPond Park Road, Hingham, MA 02043 
Mass: 800-442-8070 or 617-740-2510 










































Call Today for FREE detailed information or try Risk-Free for 31 days, any product on this page. 


800-421-8006 


FIRMWARE DEVELOPMENT 


Cc, MASM 
LINK & 
p> LOCATE > 


LINK & LOCATE enables PC users to produce ROM-based 
firmware for 8086/87/186 from object files generated by 
popular C compilers, such as from Microsoft, Lattice and 
Borland’s Turbo C, and MASM from Microsoft, Provides full 
control of segment placement anywhere in memory. Sup- 
ports output of Intel HEX file for PROM programmers, Intel 
OMF absolute object file for symbolic debuggers and in- 
circuit emulators. Includes Intel compatible linker, locator, 
librarian, hex formatter and cross reference generator. $350. 


NEW! Includes utility to support PC based PROM 
programmers. 


*SYSTEMS & 
<I SOFTWARE: **” 


3303 Harbor Bivd., C11, Costa Mesa, CA 92626 


Phone (714) 241-8650 FAX (714)241-0377 TWX 910-695-0125 
CIRCLE NO. 147 ON READER SERVICE CARD 














Since 1981 HALO 
has been the 

industry standard 
library of graphic 
subroutines for the PC. 
HALO has the largest inst- 
alled base of end-users and 
more ISV’s than any graphics 
software environment. 


Why? Because HALO grows with the 
industry. Graphics experts at Media 
Cybernetics are constantly improving 
HALO and expanding its compatibility. 
HALO supports 16 programming 
languages and over 125 devices. 
HALO is also compatible with IBM's 
new hardware series. 


Media Cybernetics offers HALO 
programmers professional support, 
flexible, practical licensing terms, and 
the continuing commitment to assure 
that HALO will always be the most 
effective graphic toolkit in the industry. 





List: $300 PS: $209 
CIRCLE NO. 148 ON READER SERVICE CARD 
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Your complete source for software. services and answers 
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U-GHESI 


A Preemptive Multitasking Kernel Continued, 
Lattice dBC, and Compiler Controversies 


™ ast month I presented the users’ 
Bisa and part of the code for a 
small, preemptive multitasking 
kernel. This month's column fin- 
ishes up with the rest of the code 
and a description of how the sub- 
routines work. The code appears in 
Listings One to Seven on pages 110- 
123 of the December 1987 issue. 

I can only hope to give you a 
bare-bones introduction to operat- 
ing system innards here. If you're 
starting out from scratch and want 
to pursue the matter further, I can 
recommend two excellent books. If 
you're interested in kernels only 
(which is often the case for ROM- 
based systems), Ted Biggerstaff's 
System Software Tools (Englewood 
Cliffs, N.J.: Prentice-Hall, 1986) pre- 
sents both the underlying theory 
and the complete C source for a 
small multitasking kernel that runs 
on the IBM PC. Biggerstaff's OS in- 
cludes a primitive screen I/O system, 
but hard stuff—such as the disk 
l/O—is relegated to DOS. Unlike my 
kernel, though, Biggerstaff's program 
lets you run other programs as sub- 
processes. 

For a more in-depth introduction 
to operating systems in general, 
Andrew Tanenbaum’s Operating Sys- 
tems: Design and Implementation 
(Englewood Cliffs, NJ.: Prentice-Hall, 
1987) is the best book on the subject 
that I've ever seen. It’s both very 
complete in its coverage of the sub- 
ject and extremely well written. (It’s 
not often that a textbook is readable, 
but this book is a glowing exception 


by Allen Holub 


to the obfuscation-is-better rule.) 
Over the course of the book, Tanen- 
baum develops a complete Unix 
look-alike system, called MINIX, that 
runs on an IBM PC/XT or AT. He 
presents all the underlying theory 
in considerable depth as well as a 
complete implementation (in C) of 
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the MINIX kernel. He covers virtually 
every aspect of operating system 
design, from the lowest-level disk 
driver (which interfaces directly to 
the hardware) up to the context- 
swapping code. 

The book includes the full sources 
to the kernel, and if you spring for 
the accompanying disk (it’s $80 from 
Prentice-Hall), you get an executable 
operating system and full sources 
for it and most of the other pro- 
grams you need to actually use the 
operating system. (The disk contains 
a C compiler and an assembler, but 
you don't get the sources for these). 
The system provides something like 
65 commands—the basic stuff such 
as cp, chmod, and so on and big 
stuff as well, such as a shell, an 
editor, grep, tar, uniq, roff, sort, pr, 
make, and ar. All these run under 
MINIX, of course, not DOS. But for 
$80 this is one of the deals of the 
century. Unlike Gnu, a_ public- 
domain Unix look-alike system, 
MINIX is not vaporware. In fact, the 
$80 you pay for MINIX is less than 
what you pay as a media fee when 
you get the “free” copy of Gnu. 


Operating System 
Organization 
As I mentioned last month, you can 
look at an interrupt-driven 1/O 
system as an operating system. That 
is, each interrupt-service routine is 
a task, and the context swapping 
(changing from one task to another) 
is performed by the hardware every 
time an interrupt comes along. The 
task’s priority is hard-wired into the 
hardware. 

In most operating systems, how- 


ever, context swaps are done in 
other ways: either a running task 
voluntarily yields (gives up control) 
to another task or a timer interrupt 
comes along and the running task 
is preempted (control is involuntar- 
ily taken from it). The part of the 
operating system that takes care of 
the swapping (and of figuring out 
which of several tasks should get 
control at any given moment) is 
called the kernel. 

There are several ways to organize 
an operating system, two of which 
are shown in Figure 1, page 74. In 
the top diagram, the system is or- 
ganized in onion-skin-like layers. 
Unix and MS-DOS are both exam- 
ples of this organization. All I/O is 
done through the kernel, and access 
to the interrupts is done through 
the I/O system. The advantage of this 
approach is that it’s easy to manage 
system resources—for example, you 
don't have to worry about two tasks 
both trying to write to the disk si- 
multaneously; the kernel will act as 
a traffic cop. 

The second diagram in Figure 1 
shows how my own system is organ- 
ized. This organization is mandated 
by the fact that I’m using DOS to do 
my V/O and that the kernel is part of 
the running program, not part of 
DOS itself. Resource management is 
a real problem in my system be- 
cause DOS is not itself reentrant. It’s 
up to the running task to assure 
that it cannot be preempted while 
it's performing a DOS call. You can 
do this in one of three ways. 

The easiest method is to block all 
other tasks (the current task retains 
control of the CPU) using the 
t__block() and t__release() system 
calls. The problem here is that an 
/O intensive task may use up an 
inordinate amount of system time. 

An alternate approach is to use 
an exclusion semaphore. A sema- 
phore is a length 1 message queue, 
created with a_t_makequeue() 
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Announcing - the database 
_ development system that 
you designed. 


® 


C PROGRAMMERS- 
We asked what you 
wanted in a database 
development system and 

e built it! 
db_VISTA III™ is the database development system for 
programmers who want powerful, high performance 
DBMS capabilities ... and in any environment. Based on 
the network database model and the B-tree indexing 
method, db_VISTA III gives you the most powerful and 
efficient system for data organization and access. From 
simple file management to complex database structures 
with millions of records. db_VISTA III runs on most 
computers and operating systems like MS-DOS, UNIX, 
‘VAX/VMS and OS/2. It’s written in C and the complete 
source code is available, so your application perfor- 
mance and portability are guaranteed! With db_VISTA 
III you can build applications for single-user microcom- 
puters to multi-user LANs, up to minis and even main- 
frames. | 


db_VISTA III" Database Development System 


b_VISTA™: The High Performance DBMS — 


A runtime library of over 100 functions. 
Operating systems: MS-DOS, UNIX V, 
XENIX, VMS, OS/2. 

C Compilers: Lattice, Microsoft, IBM, _ 
Aztec, Computer Innovations, Turbo C, 
XENIX, and UNIX. — 
LAN systems: LifeNet, NetWare, PC Net- | 
work, 3Com, SCO XENIX-NET, other NI 
BIOS compatible MS-DOS networks. 


Bi db_QUERY:” The SQL-based Query. 
® Provides relational view of db_VISTA | 
applications. 
¢ Structured Query Language 
© C linkable. : 
® Predefine query procedures or run ad-hoc 
queries ‘‘on the fly”. 


spendently for design flexibility 
y-to-use interactive database access 


nsfer utilities for importing/export- 
ext and dBASE II/III files. 
C 3 db_REVISE™: The Database 
Restructure Program. 
¢ Redesign your database easily. 


© Converts all existing data to revised design. o : 


ture royalty-free run-time distribution, source code 
ir commitment to customer service. That’s why corporations 
Hewlett-Packard, IBM, Northwestern Mutual Life, UNISYS 

ur products. 


RAIMA’S COMMITMENT TO YOU: No Royalties, Source 
Code Availability, 60 days FREE Technical Support and 
our 30-day Money-Back Guarantee. Extended services 
available include: Application Development, Product 
Development, Professional Consulting, Training Classes 
and Extended Application Development Support. 


HOW TO ORDER: Purchase only those components 
you need. Start out with Single-user for MS-DOS then 
add components, upgrade ... or purchase Multi-user 
with Source for the entire db_VISTA III System. 

It’s easy... call toll-free today! 


db__VISTA III" Database 
Development System 


db_VISTA Il” $595 - 3960 
db_QUERY * $595 - 3960 
db_ REVISE ” $595 - 3960 


db_ VISTA” File Manager 


We'll answer your questions, help | 
determine your needs and get you started. 


CALL TODAY! 
1-800-db-RAIMA 
(that’s 1-800-327-2462) 


RAIMA 


CORPORATION 


3055 112th Avenue N.E., Bellevue, WA 98004 (206)828-4636 
Telex: 6503018237MCIUW FAX: (206)828-3131 


Starts at $195 











G CHEST 
(continued from page 72) 


system call. Normally a message is 
waiting at the queue. When a task 
wants a resource, it pends (waits for 
a message to arrive) at this queue by 
calling t__wait(). When the task has 
finished with the resource, it posts 
the message back to the queue using 
t__send(). 

A third approach puts another 
level of isolation into the picture. 
Here, a special task is in charge of 
every resource. A second task sends 
a request to the resource task (again 
using the message mechanism), 
which performs an operation and 
_ then sends the result back to the 
calling task. For example, a single 
task might be in charge of all screen 
I/O. When a task wanted to send 
something to the screen, it would 
just post a message at the screen 
task’'s input queue (the message 
would probably be a pointer to a 
string) and the screen task would 
do the actual I/O. Another example 
is a disk I/O task. Here the request- 
ing task would send a read-request 
message to the disk manager. This 
message would contain some sort 
of file descriptor,.a count of the 
number of bytes to read, a pointer 
to a buffer, and the address of a 
queue to which the disk manager 
should send a response. The man- 
ager would fill the buffer and return 


kernel 


a “done” message to the indicated 
return address when the disk access 
was complete. 

The resource-manager approach 
is often the best for two reasons. 
First, messages can’t possibly get in- 
termingled because the screen task 
will process them in the order re- 
ceived. Second, the I/O process can 
be done in parallel with other tasks. 
For example, the disk manager 
could start up a DMA transfer and 
then suspend itself by waiting on a 
queue. The interrupt-service routine 
that’s triggered by the DMA control- 
ler when the transfer is done posts 
a message to this same queue. In 
the interim, however, the disk man- 
ager is suspended, which means 
that other tasks can be active. Had 
you used the block/release strategy 
or an exclusion semaphore, all activ- 
ity would stop while the active task 
waited for the transfer to complete. 
The kernel itself contains no re- 
source managers, however. You'll 
have to write your own. 


The Data Structures 

So, what exactly is a task? Individual 
tasks (or processes) consist of sev- 
eral parts. First is the code itself. For 
reasons that will be apparent 
shortly, this code must be reentrant. 
That is, you must write it as if it 
were a recursive function—at least 
in terms of static-variable usage and 
so forth. If you're careful, several 


I/O system 


interrupt 
system 








interrupt 
system 


Figure 1: Two ways in which to organize an operating system 
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tasks can share the same code (be- 
cause, like recursive subroutines, 
they all have unique stacks—more 
on this momentarily). The second 
part of a task is a task control block, 
or TCB. The TCB that’s used by the 
kernel is defined in kernel.h (Listing 
One) starting on line 60. It’s also 
shown in Example 1, page 78. 

The TCB is shown graphically in 
Figure 2, below. The TCB structure 
forms a header, and the remainder 
of the structure is memory that will 
be used for a task’s stack. The size 
of the stack is determined at task- 
create time (it’s passed _ into 
t__create() as an argument). TCBs 
(or pointers to them) are stored in 
one of three places: in an active list, 
which is a priority queue consisting 
of all tasks that have been 
preempted and are waiting to be 
activated; queued up at a message 
(ll look at this process in a 
moment); or, if the task is the cur- 
rently running task, a pointer to the 
task is held in the global variable 
T__active. 

Several things happen when a 
timer interrupt comes along. First, 
the various message queues are ex- 
amined, and if any of the tasks wait- 
ing at these queues have timed-out, 
they are added to the active list. 
Next, the priority of the running task 
is compared with the highest-prior- 


ity task in the active list, and if the | 
latter is higher, a context swap is | 





TCB structure 








Figure 2: Graphical representation 
of the TCB used by the kernel 
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Simply the BEST C and 
Pascal on AT, 386, Sun, 
Apollo, RT, VAX, 370 


“The most rock-solid C compiler in the industry. Superb technical 
support and portability. Superior code generated.” 

Gordon Eubanks, Symantec — Q&A (386). 

“It simply works, with no trouble, no chasing strange bugs, and ex- 
cellent warning and error messages ... a professional product.” 

Robert Lerche, Bay Partners. 

“For large-scale software development, the highest quality C compiler 

available on the market today. Pragmas are great. Quality of 

support is exceptional.” Randy Neilsen, Ansa—Paradox (D0S,0S/2). 


“15% smaller and 15% faster than Lattice C.” 
Robert Wenig, Autodesk. 


“Our software is running anywhere from 30 to 50% faster than when 
compiled under Lattice.” David Marcus, Micronetics. 


“We switched from Lattice due to a 10% reduction in code size. The 
compiler is very stable.” Lee Lorenzen, Ventura Software 

— Ventura Publisher, marketted by Xerox Corp. 

“Best quality emitted code by any compiler I've encountered. Often a- 
mazing.” Bill Ferguson, Fox Software — FoxBase (386). 


“Messages sometimes pointed out type mismatches, incorrect-length 
argument lists, and uninitialized variables that had been undetected 
for years [in 4.x bsd].” Larry Breed, IBM ACIS [RT PC]. 


“Diagnostics turned up bugs missed by other compilers. Rapid bug 
fixes by technical support, someone who knew what he was 
talking about. 80386 code is well optimized.” 

Tim Addison, Logistics Data Systems. 

“386 protected mode support is fantastic, especially the access to 
large amounts of memory. It's mainframe compute power on a 
ri: Dan Eggleston, Viewlogic. 

“The preprocessor supplied with Professional Pascal is quite useful. 
The code quality and control over segmentation and memory mod- 
els are superior to MS Pascal.” Bob Wallace, QuickSoft. 


Check Out These Reviews 
¢ High C ™: 
Computer Language February 1986, '87 
Dr. Dobb’s Journal August 1986 


PC Magazine Jan. 27, 1987 (80386 version) 

Dr. Dobb's Journal July 1987 (80386 version) 

BYTE Magazine November 1987 (80386 version) 
¢ Professional Pascal ™: 

PC Magazine Dec. 29, 1985 

Computer Language May 1986 

PC Tech Journal July 1986 


Journal of Pascal, Ada, & Modula-2. Nov.-Dec. 1986 
BYTE Magazine Dec. '86, June '87 (80386 version) 


Why MetaWare compilers 


¢ They are specifically designed for serious software developers. 

¢ They are reliable and robust: they don't break at every turn. 

¢ Their generated code is the best, or near best, on each architecture. 

¢ Their superior diagnostic messages help you produce better prod- 
ucts more quickly. 

¢ Your source can be ported with ease to the most popular systems. 

¢ You can link mixed-language modules from our compilers, others 

¢ You can benefit from high-level, personal technical support. 

¢ You can take advantage of the latest ANSI C extensions, and/or 
extensive Pascal extensions. High C has been tracking the ANSI 
Standard for two years; Professional Pascal will soon have a 
VS Pascal compatibility switch and several Apollo Pascal ext'ns. 


¢ You can take advantage of the latest 387 and Weitek 1167 support 
— we have the only compilers with Weitek real mode support. 
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Power Tools for Power Users 


Ashton-Tate: dBase III Plus, MultiMate; Autodesk: AUTOCAD, AU- 
TOSKETCH (8087, '387, Weitek); Boeing Computer Services (Sun); 
CASE Technology (Sun); CAD/CAM giant Daisy ('86, '386, VAX); 
Deloitte Haskins & Sells; Digital Research: FlexOS; GE; IBM: 
4.3/RT, 4680 OS; Lifetree Software (Pascal): Volkswriter Deluxe, 
GEM-Write; Lugaru: Epsilon; NYU: Ada-Ed cmplr; Semantec: Q&A; 
Sky Computers; ... (Product names are trademarks of the companies indicated.) 


Industrial-Strength 


MetaWare C and Pascal compilers are designed for professional soft- 
ware developers. These tools are loaded with options to control 
them for special purposes. You can adjust the space-time trade-off 
in code quality. You can adjust external naming conventions to 
agree with linkers and operating systems. You can specify segment 
names for segmented architectures, and to help place code or data in 
particular places for embedded applications. You can select from 
five memory models for the 8086 family. And on and on. 


A Partial List of Optimizations 


Common subexpression and dead-code elimination, retention and re- 
use of register contents, jump-instruction size minimization, tail 
merging (cross jumping), constant folding, short-circuit evaluation 
of Boolean expressions, strength reductions, fast procedure calls, au- 
tomatic mapping of variables to registers (where advantageous), ... 


“Platform” — Code Quality 


Sun,Apollo,SGI— 18%, 3%, 26% > resident compiler (Dhrystone). 
PC: DOS, OS/2 — 3-10% > Microsoft C; 30% > MS Pascal, LatticeC. 
386 32-bit DOS— no competitors, since November, 1986. 

286, 386 UNIX — 66% better than pcc (Dhrystone, 386). 

VAX VMS — = DEC's excellent C and Pascal; better features. 
VAX Ultrix — 19% > pcc (Dhrystone); much > Berkeley Pascal. 
RT PC/4.3bsd — 89% > the original port of pcc (Dhrystone). 

370 CMS,UNIX— much better than any C, and VS Pascal. 

AMD 29000 — >40,000 Dhrystones! Available in Q2, cross. 


(408) 429-6382, telex 493-0879. Since 1979. 


Wats NN, Lar 


INCORPORATED 
903 Pacific Avenue, Suite 201 ¢ Santa Cruz, CA 95060-4429 


The Clear Choice for Large 


Programming Projects —:<1.:: 


1987 MetaWare Incorporated. MetaWare, High C, Professional Pascal, and DOS Helper are 
trademarks of MetaWare Incorporated. Others and their owners are duely respected. 
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Nobody ever said programming 
PCs was supposed to be easy. 
But does it have to be tedi- 
ous and time-consuming, too? 


N ot any more. Instant Access eS 5 ae pe ee Spr a: ena 
: : @ Memory-resident—uses just 71K. chart, keyboard codes, error codes, 
Not SInNCce the arrival of @ Full-screen or moveable half-screen operators, etc. 
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view, with pull-down menus. 
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know to program in your 
favorite language. 
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for people who h 


the remarkable new program 
in the lower right-hand corner. 

Which is designed to save 
you most of the time you're 
currently spending searching 
through the booksand manuals 
on the shelf above. 

The Norton On-Line Pro- 
grammer’s Guides are a quar- 
























® Auto lookup and searching. 
® Tools for compiling your own databases. 


ASSEMBLY (600K of data) 

# DOS Service Calls: All INT 21h services, 
interrupts, error codes, FCB and PSP 
fields, standard handles and more. 

® ROM BIOS Calls: All ROM calls plus low 
RAM usag 


e. 
® Instruction Set: All 8088/86 instructions, 


addressing modes, flags, bytes per 
instruction, clock cycles and more. 

= MASM: Pseudo-ops and assembler 
directives. 

® Tables: ASCII chart, line-drawing charts, 
keyboard scan codes and more. 





C (600K each database) 

® Microsoft C and Turbo C: Describes 
language, including statements, 
operators, data types and structures. 

@ Library Functions: Detailed 
descriptions of all functions, from 
abort () to write (). 

= Preprocessor Directives: Describes 
commands, usage and syntax. 

@ Tables: ASCII chart, line-drawing 
characters, keyboard codes, error codes, 
operators, etc. 


PASCAL—Turbo (360K of data) 
= Language: Describes statements, 
syntax, operators, data types and 
records. 





BASIC (270K each database) ® Library: Describes the librar 
te} of pop-up refer ence | rh ee QuickBASIC procedures, ope pee 
and Turbo : @ lables: chart, line-drawing 
packages that do the same = Statements and Functions: Describes all characters, keyboard codes, error codes, 
things in four different statements and built-in library functions. reserved words, etc. 
languages. 
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Each package consists of 
two parts: A memory-resident instant 
access program. And a comprehensive, 
cross-referenced database crammed 
with just about everything you need to 


(If you don’t believe us, you might want 
to take a moment or two to examine the 
data box you just passed.) 

You can, of course, find most of this 


Designed for the IBM“ PC, PC-AT and DOS compatibles. Available at most software 


information in the books and manuals 
on our shelf. 

But Peter Norton—who’s written a 
few books himself—figured you’d rather 
have it on your screen. 

In seconds. 

In either full-screen or moveable half- 





cee See SSE SSE SL at ca ee 

A Guides reference summary 
screen (shown in blue) pops up on 
top of the program youre working 
on (shown in green). 


Summary data expands on 
command into extensive detail. 
And you can select from a wide 
variety of information. 


screen mode. 

Popping up right next to your work. 
Right where you need it. 

This, you're probably thinking, is pre- 
cisely the kind of thinking that pro- 
duced the classic Norton Utilities. 

And youre right. 

But even Peter Norton can’t think of 











everything. 

Which 1s why there’s a built-in com- 
piler for creating databases of your own. 

And why all Guides databases are 
compatible with the instant access pro- 
gram in your original package. 

So you can add more languages without 
spending a lot 
more money. 

‘To get 
more informa- 
tion, call your 
dealer Or 
call Peter 
Norton at 
1-800-451- 
0303 Ext. 40. 

And ask 
for some 
guidance. 
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dealers, or direct from Peter Norton Computing, Inc., 2210 Wilshire Blvd. #186, Santa Monica, CA 90403. 213-453-2361. Fax 213-453-6398, MCI Mail: PNCI ©1987 Peter Norton Computing 
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Only WATERLOO C's programming environment 







delivers all 10 of the most wanted user features: 


IW High-speed compilation 
IW High-performance code 
7 Reentrant code options 
WY OS linkage options 


W In-line functions 


WATERLOO C Version 3.0 is the 
high-performance development system 
for IBM 370 mainframe architectures 
under VM/CMS consisting of: 


¢ Optimizing C Compiler 

e C Run-time Library 

¢ Interactive Source-level 
Debugger 

¢ Development Tools 


WATERLOO C is ideal for new soft- 
ware development and for porting existing 
software to IBM mainframes. It provides 
ANSI standard support in an integrated 
CMS environment for portability and effi- 
ciency. And it puts all the resources of a full 
development system at your fingertips so 
you can quickly achieve quality results. 


WATERLOO C improves your 
response time and conserves your main- 
frame resources with an extremely fast 
compilation rate. A single phase from 
source to object means less overhead, 
while both the compiler and library can 
reside in shared segments for even faster 
compiles and links. 


WATERLOO C generates the highest 
quality code with an exclusive state-of-the- 
art optimizer. Options for reentrant applica- 
tions and OS linkage conventions mean 
flexibility in development. Moreover, a 
convenient option allows you to see the 
original source lines as comments in the 
assembler output. 


The source-level debugger lets you 
work with your programs the way you 
wrote them. The full-screen interface feels 
so natural that it is easy to use. Debugging 
activity is performed using source varia- 
bles, functions, and lines. And fp 
the execution environment 
allows stepping, breakpoints, 
tracing, and display and alter- 
ation of your program data. 
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W ANSI compiler and library 
W Full-screen library 
W Full-screen symbolic debugger 


WW Extensive on-line documentation 
'W Development tools 


Completing the development environ- 
ment are these important productivity 
tools: 


e Update your programs with a single 
command: MAKE. 

e Simplify multi-file maintenance with 
GREP and DIFF. 

e Track source variables and functions with 
cross-reference utilities. 

e Spot performance bottlenecks with a 
program execution profiler. 


A full support framework provides com- 
plete technical backup. Access documen- 
tation easily on-line or in comprehensive 
reference manuals. Our Customer Support 
Center provides you with expert technical 
assistance. Newsletters keep you informed 
about product developments. And on-site 
installation and training workshops are 
available. 


Discover 
the high- 
performance 
advantage of 
WATERLOO C. 
> Write or call for our 
=.’ complete information 
: package: 


i 
i 
; 
d 
é 
: 
i product information package. 
d 
j 
i 
i 
i 
j 





WATERLOO C 3.0 full-screen debugger: A quick route to quality results. 






Find out how quickly and easily you 
can generate the highest quality code 
for IBM mainframes by writing or 
calling for the WATERLOO C complete 


Please send your product 
information package. 


L | 
& 


Name: a 

| Title: 
Company: ; 
i Street: i 
City: : 
Cite oF 
ao 

: 

c 


| would like to arrange for an 
evaluation copy. 

















: Telephone: 





Dept. DD-01 
I 415 Phillip Street 
I Waterloo, Ontario, Canada N2L 3X2 


I Tel. (519) 886-3700 


i a le a 
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C CHES 
(continued from page 74) 


performed as follows. The value of 
the system clock (held in T__clock) 
is copied into the timestamp field of 
the structure. Then all the registers 
except SS and SP are pushed onto 
the current task’s stack. Next, the SS 
and SP registers are copied into the 
ss and sp fields of the TCB. Now the 
new task is dequeued from the 
active list and the old task is 
enqueued in its place. The new task 
is installed, first by copying the ss 
and sp fields into the corresponding 
registers (thereby making the new 
task’s stack the active stack) and 
then by popping all the registers. If 
you've done a context swap, the 
popped registers will be those that 
were saved the last time the task 
was suspended, not the registers 
that were saved when you entered 
the timer interrupt-service routine 
(which are in the suspended task’s 
TCB). 

Note that the time of last preemp- 
tion is considered when a task’s pri- 
ority is examined. That is, if two 
tasks have the same priority, then 
the one that has been waiting long- 
est is considered the higher-priority 
task. This is how round-robin sched- 
uling works. 

The other fields in the TCB are 
used for debugging and message 
passing. The three debugging fields 
are tag, which points to the string 
that you passed into t__create( ); ini- 
tial__sp, which is the initial value of 
the stack pointer; and status, which 
tells you if a task is currently waiting 
for a message or not. The kernel 
doesn't use these fields for anything. 
The tag field is particularly useful 
because it lets you see which task is 
actually attached to a given TCB— 
you can pass the task name to 
tcreate( ). 

The remaining fields are used for 
the message-passing system. The 
next field is used to maintain a 
queue of tasks, all of which are wait- 
ing at the same message queue. The 
TCBs of these tasks are arranged as 
a linked list, with new tasks being 
added to the end of the list. The 
first TCB in the list gets a message 
when one arrives at the queue. This 
is accomplished by unlinking it from 
the list, setting the msg field to point 




















typedef struct tcb- 
{ . 
**sp; /* Task-swap stuff */ 
Ss; 


void 
unsigned 


priority; 
timestamp; 


unsigned 
unsigned long 
unsigned wait; /* Message-management 
stuff */ 

*next; 


*msg; 


Struct tcb 
void 


status; 
*tag; 
**initial sp 


int 
char 
void 


/* debugging stuff */ 


void *stack{1]; /* Base of system stack 


Example 1: The TCB used by the kernel 















typedef struct t queue 
{ 


int signature; 
struct € queue *next; 


TCB *Cask bh; /* Task queue */ 
TCB *Caskx C; 
int q size; /* Message queue */ 
int numele; 
void **headp; 
void “*Caiip-: 
void *queue[l1]; 
} 
T QUEUE; 






Example 2: The T__QUEUE structure 


T_QUEUE T__QUEUE 







T__queves__» next (0) 





tailp 
headp 






reece “message ] $2 
tcb 


—————-—-—_y>-_-—«“ MOSSAGE 2” 


next 
————=—_j- +~=« MeESSage 3” 


space for 
other 


messages 





next 
(0) 


a 


Figure 3: A list of two queues, the first of which has two tasks waiting at it 
and the second of which has three messages enqueued and no tasks waiting. 
Only relevant fields are shown. — 
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C CHEST 
(continued from page 79) 


at the message, inserting the task 
into the active list, and then forcing 
a reschedule (as if a timer interrupt 
had come along). The wait field is a 
counting semaphore. It is initialized 
to the time-out value that you pass 
to t__send() and is decremented on 
every timer interrupt. When it gets 
to 0, the task is removed from the 
message queue and put back into 
_ the active list with the msg field set 
to NULL. 

The next data structure of interest 
is the T__QUEUE structure, defined 
on lines 98-113 of Listing One and 
in Example 2, page 79. T__QUEUE is 
a variable-length structure similar to 
a TCB. Here, however, the area at 
the end of the queue is the message 
queue itself (rather than the stack). 
Queue is the first cell of that area. 
The headp and tailp fields point at 
the head and tail of the message 
queue and numele is the number of 
messages currently in the queue. 
The g__size field is the maximum 
number of messages that the queue 


SourceTools 





can hold. Waiting tasks are queued 
up using the task_h and task__t 
fields. The former points to the first 
element in the linked list and the 
latter points at the last element. 


Self-modifving 
code turned out 
to be an easy 
work-around 


The queues themselves are also 
arranged in a linked list, put to- 
gether in the order in which the 
queues are created. The timer inter- 
rupt-service routine chases down 
this second list looking for timed- 





out tasks. The next field points to 
the next queue in that list; the situ- 
ation is illustrated in Figure 3, page 
79. Finally, the signature field con- 
tains an arbitrary number that’s 
used by some of the queue func- 
tions to make sure that the 
T__QUEUE pointer passed to them 
is valid. 


The Subroutines 

Once you understand the data struc- 
tures, the actual code is pretty 
straightforward. Schedule.asm (List- 
ing Two) contains the timer-inter- 
rupt-related stuff. It is very similar 
to the speedup() subroutine de- 
scribed in the September 1987 C 
Chest, so I won't go into details 
here. 

__T__speedup() (line 182) speeds 
up the IBM PC system clock by an 
indicated factor and installs an inter- 
rupt-service routine that does con- 
text swaps when required; __t_—slow- 
down() (line 241) slows the clock 
down again and removes the sched- 
uler. T__block() and t__release() 
(lines 165-175) just set or clear a 
global flag (blocked, declared on line 


Writer/Director 
of Technical Books 


FULL SOURCE CODE MANAGEMENT 


[FULL SOURCE CODE MANAGEMENT 


@ Document revision history for management information 

™ Provides security to prevent conflicting changes to modules 
@ Audit trails through user ID, comments, time and date stamps 
@ Branching and key word insertion for enhanced productivity 
@ Utilities for easy maintenance of parallel source files 


| POWERFUL MAKE FACILITY 


m Provides automatic rebuild of changed and dependent modules 
= Macro substitution utility, preview capability, nested MAKE files 


and more... 


= Sophisticated space-saving delta storage algorithm 


AVAILABLE FOR VAX, PDP-11 & MS-DOS 


To order or for more information, call 1-800-874-8501. 


For PO’s or checks: Oregon Software, 


| want top performance 
at an affordable price 


6915 SW Macadam Ave., Portland, OR 97219. 


ORECONG 


Ry 
NM 
Ny 


SOFTWARE 


Writer/Director of technical book 
line, responsible for writing and 
directing the development of PC 
and PS/2 hardware books, 
Operating systems books, and 
programming books. Applicant 
must have software experience and 
demonstrated proficiency in two 
Or more programming languages. 
PC-mainframe communications, 
and applications experience a plus. 
Send resume and salary 
requirements to: 


Personnel Director 
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C CODE FOR, THE PC 


source code, of course 
C Source Code 


Bluestreak Plus Communications (two ports, programmer’s interface, terminal emulation) . .. . $400 
CQL Query System (SQL retrievals plus windows) .. . ie a vis at woe ae ee 
Greenleaf Data Windows (windows, menus, data entry, interactive form design) 5 dile wticw a ee ¥ | eee 
Barcode Generator (specify Code 39 (alphanumeric), Interleaved 2 of 5 (numeric), or UPC) .. . $300 
GraphiC 4.0 (high-resolution, DISSPLA-style scientific Ee in color & ae bediony pe ae. 6a a tee 
Vitamin C (MacWindows) . . , he hn oe te oY 
resident C (TSRify C programs, DOS shared libraries) . Lee toe Sle ee 
Greenleaf Communications Library (interrupt mode, modem éontial, XON-XOFF) i oe) ete. 
Greenleaf Functions (296 useful C functions, all DOS SEPVISCNT 5 boo ee ea, ee eRe ee 
Essential C Utility Library (400 useful C functions) . . re 
Essential Communications Library (C functions for RS- 232-based communication systems) pif gf A me WOO 
PC/IP (CMU/MIT TCP/IP implementation for PCs) . . . Ag Mea one feo 8 Pe Say ee 
B-Tree Library & ISAM Driver (file system utilities by Softfocus) sid carecy oat lot gia Eo ww eT! 
The Profiler (program execution profile tool) . . . ee. wre es! 7 
Entelekon C Function Library (screen, graphics, keyboard, string, nriiter, ate: Bete thee 4 
Entelekon Power Windows (menus, overlays, messages, alarms, file handling, etc.) . . . . $100 
QC88 C compiler (ASM output, small model, no longs, floats or bit fields, 80+ function library) . . $90 
CBTree (B+tree ISAM driver, multiple variable-length keys) ois als 4 See +5 n oe 
MultiDOS Plus (DOS-based multitasking, intertask messaging, semaphores) Foie he em Se ove? Se ese tne 
ME (programmer’s editor with C-like macro eee is nen esa wie in: “oth. “aalae ki “ale Sh 
Wendin PCNX Operating System Shell .. . wa te kid tee FY ge 
Wendin PCVMS Operating System Shell. ... ... . 2 0 ec 'e we ee ew we ee ww ww OTE 
Wendin Operating System Construction Kit . . oat we 2 Ae mops Ande oe NG \ yee, BENE TR 
EZ_ASM (assembly language macros bridging C snd MASM) . a 2 doo ry cae og, on tia, sph OD 
Multi-User BBS (chat, mail, menus, sysop displays; uses Galacticorun modem card) . Scns. Ps tele 
Heap Expander (dynamic memory manager for expanded UEIORP a me Fe tee ek Rw glee ee), ee 
Make (macros, all languages, built-in rules) .. . pe gece ee ese. yee 
Vector-to-Raster Conversion (stroke letters & Tektronix 4010 codes to bitmaps) Coat im, 6m 1k rag ong ce 
Coder’s Prolog (inference engine for use with C programs) . . . cs! whore as a 
PC/MPxX (light-weight process manager; includes preemption and ecorentine packages) se ae ee 
Biggerstaff’s System Tools (multi-tasking window manager kit) ...........4..4.... $40 
CLIPS (rule-based expert system generator, Version 4.0)... ....... 2.506244 2. « $85 
TELE Kernel (Ken Berry’s multi-tasking kernel) . ...... 2... 2... ee ee ee ee ss $30 
TELE Windows (Ken Berry’s window package) . : pled aod) ts on gle te Se eS: 
Clisp (Lisp interpreter with extensive internals documentation) nafs sta ee, Re ES wl 
Translate Rules to C (YACC-like function generator for rule-based systems) ee ee ee ee 
6-Pack of Editors (six public domain editors for use, study & hacking). ............. $30 
ICON (string and list processing ae halal Verso 6 and update). os one ik ee ce ew eee BBB 
PTree (parse tree management)... . . re rn ee ee ee er a ae ee 
LEX (lexical analyzer generator) .. . os, eee oe. ee 
Bison & PREP (YACC workalike parser generator & attribute érohimar r preprocessor) 5 ot oes eee 
AutoTrace (program tracer and memory trasher catcher) 7 oe Lig hy ae a 
C Compiler Torture Test (checks a C compiler against K&R) ............4.2.+4 2. . $20 
Benchmark Package (C compiler, PC hardware, and Unix system) . Ye koe ee tw, yee 
TN3270 (remote login to IBM VM/CMS as a 3270 terminal on a 3274 ¢ controller) 42 42 a 
PKG (task-to-task protocol package) .. . se ae we! a ge RO 
A68 (68000 cross-assembler) . sel Rite elajo ang ingle. wi ae, ay. 6 ee I ee 
Xlisp 1.5a (Lisp interpreter including tiny-Prolog i in . Lisp) Eta ade tau mg SB ch. aah ty a, Oak Ty, Oe 
List-Pac (C functions for lists, stacks, and queues)... 1... . ee ee ee eee ee ee «$20 
XLT Macro Processor (general purpose text translator) .. . oho lly oD 
C Tools (exception macros, we, pp, roff, grep, printf, hash, dadare, , Pascal-to-C) ope Sa te See 
Data 

DNA Sequences (GenBank 48.0 of 10,913 sequences with fast similarity search program) . . .. . $150 
Protein Sequences (5,415 sequences, 1,302,966 residuals, with similarity search en aoe a ee 
Webster’s Second Dictionary (234,932 porda) : . . . $60 
U. S. Cities (names & longitude/latitude of 32 000 U.S. cities and 6 000 state boundary points) 5s 4 
The World Digitized (100,000 longitude /atitude of world country boundaries) 7 iow 88 
KST Fonts (13,200 characters in 139 mixed fonts: specify TRX or bitmap format) ....... . . $30 
USNO Floppy Almanac (high-precision moon, sun, planet & star Pee fy eee Re kee ead 
NBS Hershey Fonts (1, 377 stroke characters in 14 amy vl te ee ae ee ae 
Se" Mar (15,701 pomte of state boutidaries) 9 ie ea soe On Vie ee welche $15 
The Austin Code Works Voice: in 258-0785 
11100 Leafwood Lane BBS: (512) 258-8881 
Austin, Texas 78750-8409 FidoNet: 1:882/12 
USA UUCP: uunetlacwhnfo 
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C CHEST 512 of Listing Six) scans the list of | and installs a new one as if it were 


(continued from page 80) 


118) that will be examined by the 


interrupt-service routine, serv, on 
lines 281-345. The flag is checked 
on line 285, and if it’s set, numblk is 
incremented (for statistics purposes 
only—it tells you how many inter- 
rupts were blocked) and control 
passes to servexit on line 327. The 
code on lines 328-240 vectors to the 
default DOS interrupt-service rou- 
tine every N interrupts, where N is 
the original speedup factor; other- 
wise, a nonspecific EOI is issued to 
the timer chip and an JRET is exe- 
cuted. 

The actual context swap is straight- 
forward. Registers are pushed on 
lines 295-302. Note that the CS, IP, 
and flag registers are saved by the 
hardware as part of the interrupt- 
service procedure, so you don't have 
to push them again here. The cur- 
rent SP and SS are saved on lines 
306 and 307, a local stack is then 
installed, and the C_ subroutine 
__t__reschedule() is called on line 
313. This subroutine (starting on line 








Cogent Prolog 


oO Fast, Compact, COMPILED Prolog 


o IBM PC and Compatibles 


oO Clocksin & Mellish Standard, Plus 
Strings 

Modules 

o Window Based Development System 


Windows 
Floating Point 


o Context Sensitive Help 


o User Specifiable Error Handling 
oO Interface to "C" and Assembler 
o Can Produce .EXE Files - No Royalties 


$200 


VISA - 


Cogent Software, Ltd. 





MasterCard - Check 
30 Day Money Back Guarantee 


messages and times out appropriate 
tasks (in the for loop on lines 532- 
550). It enqueues the running task’s 
TCB and sets T__active to the new 
task’s TCB when a context swap is 
required (on line 567). 

Now control returns to the assem- 
bly-language code. The new TCB 
(which is the same as the old one if 
no swap is necessary) is fetched on 
line 315 of Listing One. Then the 
stack is restored, registers are 
popped, and you keep going. So, if 
you're doing a context swap, you'll 
save registers on the old TCB and 
then restore them from the new one. 
Note that the CS, JP, and flag regis- 
ters are restored as part of the IRET 
instruction. 

All the other assembly-language 
stuff is in swap.asm (Listing Three). 
The routines in this file are not par- 
ticularly well structured—that is 
they save space by sharing code. 
One subroutine will jump into the 
middle of another. The central rou- 
tine is __t__swap__in() on lines 172- 
242. It is passed a pointer to a new 
TCB. It suspends the current task 


Feature this: 


(includes free 








Announcing 
WKS LIBRARY 


the timer interrupt-service routine. 
Again, registers are saved (lines 183- 
198), T__active is modified (line 216), 
and the new task is installed by 
popping registers (lines 227-242). 
Note that the subroutine’s return 
address is used as the old task’s 
saved IP register. This means that 
when control is restored to the task, 
you'll be back in the calling subrou- 
tine, just after the —t swap__in() 
call. 

The other swap-related functions 
are _t__install() (lines 142-168), 
which deletes the current task and 
installs a new one,~— and 
__t__ shazam(), which starts up mul- 
titasking. Both of these jump into 
the middle of __t-swap__in (to the 
shazam label on line 223) to install 
the new task. __T_shazam also 
changes the stack probe subroutine, 
chkstk, which is called at the start 
of all normal subroutines. I couldn’t 
use the normal chkstk because the 
task stacks are in strange places (in 
the middle of the heap in fact), so 
the default chkstk would always fail. 
The new routine checks the current 
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Now you can write and read Lotus worksheets 
directly from a C program! 


WKS LIBRARY lets you: 


© avoid time-consuming file translation steps 

¢ control the execution of 1-2-3 from inside your application 
¢ use Lotus as a data entry screen in your C program 

© generate ‘‘live’’ 


financial statements with formulas for totals 


¢ reads and writes .WKS, .WK1 and .WR1 worksheets 

¢ writes integers, floats, strings, formulas, macros and dates 
using wprintf() 

¢ reads using wscanf(), converting column contents to C 
variables according to format specs 

e has low-level functions for manipulating individual cells 

© provides Lotus control functions such as: 
formats, column widths, initial cursor position, range 
names, cell protection 

© supports Lattice, Microsoft & Turbo compilers for DOS, plus 
most UNIX environments 

Source Code provided 


Only $89 = 


No Se on executable programs 
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i; CHEST 
(continued from page 82) 


SP against the current TCB’s stack 
base and reports an error if the 
_ stack gets too large. 

Note that the installation proce- 
dure involves actually modifying the 
first couple of instructions of the 
default chkstk subroutine to jump 
to the new one (on lines 271-274). I 
know this is a kludge, but Version 
4.0 of the Microsoft compiler (and 
early betas of Version 5.0) made it 
virtually impossible to link in my 
own chkstk. (At least, I tried for a 
couple of hours with no success.) 
Self-modifying code turned out to 
be an easy work-around, but it’s a 
stopgap measure, and I mean to fix 
it once I figure out how. 

The final routine of interest is 
__t__stop() (lines 94-138), which is 
called to terminate multitasking. It 
causes control to pass back to the 
instruction following the original 
t__start call—the return address 
was saved by t_start(). T__stop()’s 
argument is passed back as the 
return value of t__start(). That is, a 
call to t__stop(5) will cause t__start() 
to return a value of 5 to its caller. 
| The situation is analogous to an 
exit() call. 

The remainder of the code is 
straightforward enough and _ suffi- 
ciently commented that there's no 


void 
PQ 
{ 


} 


*pq look( queue ) 
*queue; 


return queue->nitems ? 


need to go through it here. I do 
suggest that you read it, though. It’s 
pretty interesting. I'll finish with a 
caveat. I've used the routines printed 
here in a couple of application pro- 
grams, and they seem to work fine. 
These program all use my own 
direct video I/O functions to write to 
the screen, however, and they don't 
do any disk I/O. It’s possible to use 
DOS, but you'll have to implement 
one of the resource management 
strategies discussed earlier (or use a 


nonpreemptive system). Do not call 


DBASE has spread 
like a disease 
through the 
small-business 
community. 


DOS directly from a task without 
assuring that the task has control of 
the system for the life of the DOS 
call. 

I’m reasonably sure that the code 
presented here is bug free, but I 


queue->heap : NULL ; 


int pq rep_ace( p, target, item } 


PQ eo: 
void *item, 


{ 


*target; 
anc 8 00S (2 use: 


Z£( siots in use = 
{ 
memcpy ( target, 
memcpy( p->heap, 


p->nitems ) 


p->heap, p->itemsize ); 
item, 


p->itemsize ); 


reheap down( p, p->heap ); 


} 


return siots in use ;- 


Example 3: The routines pq_—look( ) and pq__replace( ) 


won't swear to it. If you find a bug 
please report it to me c/o Software 
Engineering, P.O. Box 5679, Berkeley, 
CA 94705. Use E-mail to leave a mes- 
sage on CompuServe (because I 
don't log on reliably enough to guar- 
antee that the message won't roll off 
the forum message board before I 
see it). Post a message on the forum, 
though, so everybody can see it. 


Priority-Queue 
Routines in the Kernel 
In addition to the various subrou- 
tines presented this and last month, 
the kernel uses the priority-queue 
routines from the June 1987 C 
Chest—you should look at that arti- 
cle for detailed information on how 
these routines work. I've modified 
the original code just a bit, however. 
The pq_—look() routine now re- 
turns NULL if the queue is empty. It 
used to return garbage in this situ- 
ation. I’ve also added a “replace” 
routine that replaces the highest- 
priority element in the queue with a 
new element, reheaps, and then re- 
turns the former top element. It’s as 
if you did a delete of the old ele- 
ment followed by an insert of the 
new one, but it takes less time than 
would two operations. Both modifi- 
cations are shown in Example 3. 
Also note that a bug fix that affects 
pq__insert() was mentioned in the 
August 1987 C Chest, page 108. 


Nifty Stuff: The Lattice 
dBC Library 

Every programmer should have a 
database management library in his 
or her toolbox. This month I'll look 
at one such library—I'll look at 
others in future columns. 

There are a host of database pack- 
ages on the market, all with their 
own set of strengths and weak- 
nesses. One of the weakest, from a 
database management point of view, 
is Ashton Tate’s dBASE III. Unfortu- 
nately dBASE has spread like a dis- 
ease throughout the small-business 
community. Consequently, it’s often 
necessary to put together a dBASE- 
compatible application program, 
even if you'd rather use ohe of the 
more efficient database packages. 

DBASE III is actually a program- 
ming language of sorts. In practice, 
it’s so limited and hard to use that 
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no sane person would write a com- 
plicated application in it (at least 
not if they want to retain their 
sanity). As a consequence, several 
fourth-generation languages that sup- 
port the dBASE file structure, such 
as FoxBASE and Quicksilver, have 
sprung up. These products have 
problems, too—they’re limited in 
one way or another. I want to write 
my applications in C, not in some 
inherently inefficient and much too 
limited 4GL that’s really designed 
for nonprogrammers. My programs 
will be faster and I can use all the 
other C functions (such as window 
management packages) that are at 
my disposal. 

The Lattice dBC III and dBC III 
Plus packages provide a solution to 
this problem. These packages are 
subroutine libraries that you can 
link into your programs to access 
dBASE III or dBASE III PLUS data- 
bases. The version that I used links 
to Microsoft-generated code, not Lat- 
tice-generated (though versions for 
the Lattice compiler are available, of 
course). Versions of the package are 
available for versions of dBASE down 
to dBASE II. The main difference 
between the III and the III Plus 
version of dBC is networking sup- 
port (you can lock whole databases, 
individual records, and bytes within 
the record). The package comes with 
small-, medium-, and _ large-model 
libraries as well as a demo program 
(and the sources for the demo pro- 
gram). Though the version that I 
used expected Microsoft C, Version 
4.0, it linked into a program com- 
piled under Version 5.0 without diffi- 
culty. (You can’t use the new com- 
bined libraries, however—the com- 
ponents have to be on the disk.) 

I have very mixed feelings about 
this package. On the plus side, it 
really does what’s required. It took 
me an hour or so to read the 
manual, and a few hours later I had 
a working C program that was ac- 
cessing a database created by dBASE 
Ill PLUS. You should have no diffi- 
culty doing the same, even if you've 
never worked with dBASE itself. 
Keep all this in mind as you read 
the negative comments that follow. 
Though the package has problems, 
most of them are fixable and dBC is 
really useful. 

Unfortunately, this ease of use has 
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FULL AT&T C++ for half the price of our competitors! 


Guidelines announces its port of version 1.1 of AT&T’s C++ translator. As an 
object-oriented language, C++ includes: classes, inheritance, member functions, 
constructors and destructors, data hiding, and data abstraction. ‘Object-oriented’ 
means that C++ code is more readable, more reliable and more reusable. And that 
means faster development, easier maintenance, and the ability to handle more 
complex projects. C++ is Bell Labs’ answer to Ada and Modula 2. C++ will 
more than pay for itself in saved development time on your next project. 


C++ 


from GUIDELINES for the IBM PC: $195 











Requires IBM PC/XT/AT or compatible with 640K and a hard disk. 
Note: C++ is a translator, and requires the use of Microsoft C 3.0 or later. 








To order: 
send check or money order to: 


Here is what you get for $195: 

¢ The full AT&T vl.1 C++ translator. 

¢ Libraries for stream I/O and complex math. 

- "The C++ Programming Language”, the 
definitive 327-page tutorial and description 
by Bjarne Stroustrup, designer of C++. 

¢ Sample programs written in C++. 

¢ Installation guide and documentation. 

¢ 30 day money back guarantee. 


GUIDELINES SOFTWARE 
P.O. Box 749 
Orinda, CA 94563 


To order with Visa or MC, 
phone (415) 254-9393. 
(CA residents add 6% tax.) 


C++ is ported to the PC by Guidelines under license from AT&T. 
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Our software comes with something 
no one else can offer. 


When you join the Lattice family 
of customers, you'll discover that 
your software purchase is backed 
by more than just an excellent 
warranty. It’s backed by unparal- 
leled technical support. By a total 
commitment to your success and sat- 
isfaction. And by Lattice’s dedication 
to excellence in products and services. 


Unlike other software manufacturers 
who charge you for services after you’ve 
purchased their product, Lattice offers 
a unique package of support programs 
at a price we can all live with—FREE. 


Lattice Bulletin Board Service 
LBBS is our 24-hour a day bulletin 
board system that allows you to obtain 
notification of new releases, general 
information on Lattice products, and 
programs for the serious user. And if 
you ve ever experienced the frustration 
of having to wait a year or more for 

a new release (that has corrected a 
bug), you'll really appreciate LBBS. 
Because with this service, you can 
actually download the latest program 
fixes to instantly eliminate any bugs 
discovered after release. 


Available through dealers and 
distributors worldwide. 


Lattice Service. 


Technical Support Hotline 
Responsible, dependable and capable 
Support Representatives are only a 
phone call away. You will talk to a highly 
skilled expert who is trained to answer 
any questions you have relating to 
specific Lattice products. Remember, 
your complete satisfaction is our goal. 


McGraw-Hill BIX™ Network 
The Byte Information Exchange (BIX) 
Network is a dial-in conference system 
that connects you with a Special Interest 
Group of Lattice users. The nominal 
one-time registration fee allows you 
to BIX-mail your questions—via your 
modem—directly to Lattice. Or you 
Can post your questions in the con- 
ference mode for Lattice or other users 
to answer. Once again, you have 
24-hour access. 
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Subsidiary of SAS Institute Inc. 


Lombard, IL 60148 
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Lattice, Incorporated 
2500 S. Highland Avenue 


Phone: 800/533-3577 
In Illinois: 312/916-1600 


You Also Receive: 

# Timely updates and exciting 
enhancements ® 30-day, money- 
back guarantee ® Lattice Works 
Newsletter ® Technical Bulletins 
# Access to Lattice User Groups 


Lattice has developed more than 50 
different Microcomputer software tools 
that are used by programmers world- 
wide. We were there for every MS-DOS 
release. We're there now for OS/2. And 
well be there for the next generation 
of technical changes. But most of all, 
Lattice is there for you. 
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more to do with the simplistic struc- 
ture of a dBASE III file than with the 
Lattice documentation. A chapter 
that described the organization of 
dBASE .dbf and .ndx files would 
have been very helpful. Data is 
stored in strange ways and an in- 
depth description of these methods 
would also be useful. (There's a de- 
scription of dBASE .dbf and .ndx 
files in Jeff Walden’s File Formats 
for Popular PC Software [New York: 
Wiley, 1986.]) 

Some of this information can be 
gleaned from the subroutine descrip- 
tions, but I'd like it all in one place. 
The manual is poorly organized and 
hard to use as a reference. For exam- 
ple, dBC functions naturally break 
into four categories: functions to ma- 
nipulate the database itself, func- 
tions to manipulate the index files, 
functions to manipulate the memo 
files, and various formatting func- 
tions. The manual, however, is or- 
ganized alphabetically (generally my 
preference), but there is no func- 
tional index. As a consequence it’s 
hard to find the function you need 
if all you know is what it does. The 
subroutine naming conventions are 
so strange that it’s hard to guess 
what the name will be. The prob- 
lems with the documentation are 
compounded by occasional errors 
in the examples. (One of them has a 
couple of stars where none belong, 
an error that caused me about ten 
minutes of unnecessary head scratch- 
ing.) 

The subroutines themselves are 
sometimes rather low level. The low- 
level functions should be included 
in the package, but higher-level ones 
are really required, too. For example, 
theré’s a host of functions that con- 
vert strings and numbers to and 
from the formats required in dBASE 
files. Fine, but as a C programmer, I 
want sprintfl )- and sscanft )-like sub- 
routines that would take care of all 
the details of the conversion for me. 
Ideally, you'd pass these functions a 
database pointer, a format string 
that identified the fields you wanted 
to access, and several objects to con- 
vert—something like this: 


dprintf( db__file, 
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“%name %street %zip”’, 
“J. P. Morgan”, “Easy St.”, 09311 ); 


and the function would do the rest 
for you. No such function is pro- 
vided, however. 

The dBC programming interface 
is very amateurish and harder to 


The package 

does the job 

and is easy 
enough to use. 


use than is necessary. I'd expect this 


sort of thing from users’ group soft- 
ware but not from professional pro- 
grammers. There are several prob- 
lems. First, Lattice has implemented 
functions with C-like names but 
with nonstandard interfaces. For ex- 





ample, the function used to open a 
database is obviously modeled after 
open(). It’s called with: 


int dBopen( filename, mode, dbffd ) 


char *filename; 
int mode; 
char **dbffd; 


There are several problems here. 
The main one is that you get back 
the file descriptor by passing in a 
pointer to a place to put it (dbffd). 
DBopen() returns an error code, but 
that’s it. I also don't like the declara- 
tion of a file descriptor as character 
pointer. It obviously isn't a string 
and shouldn’t be declared as such. 
I'd prefer either a void pointer or a 
special type (such as FILE ). 

Were I to rewrite the interface to 
this function, it would look like this: 


DBFILE *dBopen( filename, mode ) 


char *filename; 
int mode; 


It would return —1 on error and a 
file descriptor on success; there 
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would be a db__errno that would 
hold an error code and a 
db__perror() that would print an 
error message. That is, the dBC func- 
tion should be identical to open(), 
except that it should open a data- 
base rather than a normal file. If 
you're going to use this package a 
lot, it would be worthwhile to write 
a glue library that mapped the weird 
calling conventions to something 
more reasonable. 

The second problem is the func- 
tion names themselves. The names 
are the too-cryptic abbreviations 
popular with inexperienced C pro- 
grammers (such as —_dbcmsiz() or 
dBdbfbufl)). There seems to be a 
rationale to the naming conventions, 
but that rationale is never made 
clear. 

Finally, the interface has several 
built-in inefficiencies. For example, 
many values are returned from sub- 
routines in a char rather than an int. 
(Usually you pass in a pointer to a 
char, which is filled by the subrou- 
tine.) This is a classic mistake made 
by novice C programmers who think 
they're saving space by shoving data 
into chars. They're wrong. The com- 
piler must convert all chars to ints 
before they can be used in an ex- 
pression. This conversion is always 
performed, even in expressions that 
use nothing but char-size variables. 
Not only does the type conversion 
take time but also the extra code 
needed for the conversion is usually 
far larger than the data space saved. 
The only valid use for C’s char type 
is an array of the things. 

Frankly, the poor-quality interface 
makes me wonder about the quality 
of the rest of the code. The package 
does work and has been reliable in 
all the applications that I’ve written, 
but I don’t really trust it. 

In spite of the foregoing, though, I 
recommend this product to those 
of you who need to write Ashton- 
Tate-compatible programs. I intend 
to keep using it myself in these situ- 
ations. The package does the job 
and is easy enough to use. It lets 
you put together a working program 
in a reasonable amount of time with 
a minimum of fuss. Moreover, you 
can do it all in C, without having to 
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learn yet another programming lan- 
guage. To make dBC really usable, 
however, you'll need to add a layer 
of glue functions to make the pro- 
gram interface more reasonable. 

I wouldn't use dBC III Plus if I 
didn’t need dBASE compatibility, 
however. The ISAM model used by 
Ashton-Tate is not great for most 
applications. The databases them- 
selves are poorly structured, gener- 
ally hard to use, and slow. (The 
speed is Ashton-Tate’s problem, not 
Lattice’s. Any program made with 
Lattice’s package will be an order of 
magnitude faster than the equiva- 
lent dBASE III program. Nonethe- 
less, a database program that used 
a different model altogether would 
probably be faster still.) Moreover, 
the Lattice package is marred by the 
poor quality of both the documenta- 
tion and the programming interface. 
Though you could use dBC for any 
general-purpose database program, 
I wouldn't. 


Availability 

All source code for the multitasking 
kernel described both this and last 
month (including the priority-queue 
stuff) is available for $30 on an IBM 
PC 51/4” disk from Software Engineer- 
ing Consultants, P.O. Box 5679, 
Berkeley, CA 94705. Include local 
sales tax if you're ordering from Cali- 
fornia. 

In addition to the kernel code and 
the priority-queue routines, the disk 
includes an enhanced version of the 
curses window I/O package de- 
scribed in the July 1987 C Chest. 
Because the enhanced curses uses 
direct video reads and writes rather 
than going through DOS, it’s useful 
in multitasking applications that 
can’t use the DOS I/O functions. This 
version of curses supports overlap- 
ping windows (though you can only 
write to the top one) and lets you 
delete and move windows. In addi- 
tion, it lets you create boxed win- 
dows (Unix’s curses doesn't). 

The (unmodified) priority-queue 
routines are also available on Com- 
puServe in DL1 of the DDJ FORUM. 
The file is called QUE2.C. 


DDJ 


Vote for your favorite feature/article. 
Circle Reader Service No. 3. 
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- Monitor program/system execution 
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programs. 
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COLUMNS 


TO THE MACS 


Introduction, Mac Sources, Lightspeed C, and Code Corner 


t's been four years now since the 

Macintosh popped into view, her- 
alded by that great Ridley Scott Su- 
perbowl commercial. Though there 
was obvious brilliance to the design, 
there were also strong whiffs of arro- 
gance and hype. But, hey,*I've been 
accused of the latter myself. There 
was nothing to do but pop out of 
the hills and take a closer look. 

I cruised over the Siskiyous to see 
my Apple dealer buddy, John 
Manzer. I got to the store, chewed 
the fat a few minutes, scanned the 
marketing propaganda, nosed the 
technical specs, then plunked down 
at the machine. Cynical musings 
twisted my mind, but what the hell, 
let's start ‘er up. 

I didn't like the locked hardware. 
I didn't like the one drive. I didn't 
like the lack of a hard disk. I didn’t 
like the price. I didn’t like the (hah 
hah) wide selection of printers. I 
didn't like the yuppistic overtones. 

But I loved the machine. It was 
fun to use. Oh, there were flaws, but 
they seemed minor compared to 
what the creators got right. Above 
all, the interface snapped. It didn’t 
have a speed snap—not yet—but 
rather the feel-of-a-fine-tool kind of 
snap. The Macintosh communicates 
via clean visual metaphors, and 
that’s a channel with a lot of band- 
width. Something about the Macin- 
tosh interface just feels good, like 
soft light filtering through a red- 
wood forest or playful kittens ca- 
reening and bouncing about the 
world. People needed to use com- 
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puters like this. I needed to program 
computers like this. Yow! 

Four years of good nurturing has 
led to some lovely growth. We've got 
a wide array of languages, detailed 
system documentation, the Laser- 
Writer, Mac IIs, Hypercard, MultiFin- 
der, and some remarkable applica- 
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tion software. The platform’s been 
consolidated, and the best is yet to 
come. Happy birthday, Mac! Blow 
out those candles, eat up that cake, 
chug down the Jolt, get crazy with 
your buddies. Hell, Maddie Hayes’s 
got you in her office: Y’all done good. 


The Doc Gets a New Column 
And so Dr. Dobb's gets a Mac 
column. What’ll I do here? 


1. Take note of well-done applica- 
tions and extensions to the user 
interface. 

2. Review a wide array of Mac pro- 
gramming tools: software and works 
on paper. 

3. Talk with, and about the work of, 
innovative Mac programmers. 

4. Discuss some of the more interest- 
ing algorithms and data structures 
contained in the Mac ROM/OS. This 
thing’s a graduate course in pro- 
gramming, with interesting tidbits 
lurking between every LINK/UNLK 
pair. 

5. Write some code. Mac program- 
ming’s the most addictive fun I've 
had in the innards of a machine. 
The universe of the Mac ROM/OS is 
quite dynamic, so there’s a_ pre- 
mium—nay, an imperative—on pro- 
gramming that’s clean, concise, and 
careful. Yield to that imperative, then 
combine it with an interface design 
that syncs with the Mac paradigm, 
and you get applications that not 
only work but that are also fun, easy 
to use, empower your users, and 
smack of elegance. 

6. Provide access details. I'll always 
give you a box (see page 106, for 
example) filled with information 








that'll help you get hold of items 
mentioned in that month’s column. 


Reviews, Criticism, 
Objectivity 

It's a lot of hard work to get a book 
or software product on the market. 
I feel a special obligation to creators 
to be scrupulously fair with any 
review/comments/criticism of a work. 
Print’s powerful stuff. If I think some- 
thing is seriously flawed, I won't 
even bother to mention it here; I 
prefer to send a quiet note detailing 
my qualms directly to the publisher. 
I'd rather put this column’s energy 
into feeding awareness of the good 
stuff. 

A note on objectivity: I’m lucky 
enough to know and/or have worked 
with some of the people whose prod- 
ucts I may mention. But it does 
nobody any good if I let that shade 
my opinions. On the other hand, I 
don't want to ignore a good product 
just because I’ve had something to 
do with it. So I'll always mention 
any Close connections I’ve got to a 
particular item in an objectivity note. 
Just know that it’s done to help you 
weigh my opinions, not as name 
dropping. 


Getting Up To Speed 

The code samples I'll be showing 
aren't for raw beginners. This is DDJ, 
after all. But it’s easier to get up to 
Mac programming speed now than 
it was in the early days. A lot of 
resources are available to help you 
cruise the learning curve. Here’s a 
minimal list: 


1. Join APDA, the Apple Program- 
mer's and Developer’s Association. 
Godchild of Dan Cochran and Dave 
Lingwood, this is a one-stop source 
for draft and finished copies of 
Apple documentation and develop- 
ment tools as well as a wide variety 
of third-party products. Dues are a 
reasonable $20 per year, it has an 
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language programmers permit 
rapid conversion of existing DOS 
applications from “real” 8086 
mode to “protected” 286 and 386 
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mode. 































OS/286 and OS/386 are the only 
DOS extenders that span both the 
286 and 386 processors, with 32- 
bit capability today on 386s that 
yields twice the performance of | 
16-bit mode. OS/286 and OS/386 | 
have quickly become the prefer- 
red solution for developers of high 
performance, memory-intensive 
applications, including CADKEY, 
CASE, VIEWlogic, and Gold Hill, 
and premier language developers 
Lahey and Metaware. 


Our optional TOUCHDOWN ™ 
BIOS supplement provides fast 
and reliable protected mode oper- 
ation on any 286 system, even 
those with problems resetting the 
286. (Ever notice how few existing 
machines Operating System/2 
runs on?) 


If your applications are run- 
ning out of memory or need more 
speed, don’t wait for the “solu- 
tion” that means abandoning 
your investment in DOS. 
Enhance them now _ with 
OS/286 and OS/386 — products 
not promises. 


A.I. 


Architects, Inc. 


One Kendall Square, Building 400 
Cambridge, Massachusetts 02139 
(617) 577-8052 


OS/286™ & OS/386™ Benefits: 


¢ Gain multi-megabytes of direct- 
ly addressable memory (15-Mb- 
286, 4Gb-386) 

¢ Increase performance by elimi- 
nating overlays and EMS 

¢ Convert in days, not months 

¢ Continue to work with a DOS 
interface and use existing TSRs, 
device drivers, graphic routines, 
etc. 


¢ Stay compatible with the widest 


array of systems 
A.I. Architects Software Devel- 
opers Kit $495 
includes full support for: 
¢ MetaWare High C (16 & 32 bit) 
¢ Professional Pascal (16 & 32 bit) 
¢ Lahey F77L FORTRAN 
¢ Microsoft C & Fortran 4.0, 
¢ MASM, MS-Link 
¢ Phoenix PLINK86 
¢ Halo & GSS Graphics 
¢ Pharlap 386: ASM/LINK 
more to come 


Run time licenses for OS/286 
and OS/386 are available at 
nominal cost. 





The HummingBoard™ 

turns any XT or AT into the fastest 386 
system available. The dual processor 
architecture boosts performance sig- 
nificantly over comparable single 
processor systems or accelerator 
boards. Available with 2 to 24Mb 
RAM, 16 or 20Mhz speed, and 387 
floating point coprocessor. 


OS/286, OS/386 and HummingBoard are trademarks of A.I. Architects, Inc., High C and Professional Pascal are 
trademarks of Metaware, Inc., F77L FORTRAN is a trademark of Lahey Computer Systems, Inc., Microsoft and MS-DOS are trademarks of Microsoft Corp. 
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Unmatche 


Motels 
unmatched S 
performance and 
portability, we _ 
have it. The 
hottest file 
handler and 
report generator | 
on the market. _ 


The c-tree file handler offers 
unmatched file accessing speed. The 
r-tree report generator makes pro- 
ducing reports a snap. Both pack- 
ages offer unmatched portability. 
Thousands of programmers are 
using these packages in over 50 sys- 
tem environments: DOS, UNIX, 
XENIX, OS/2, MACINTOSH, VAX, 
TOWER and 


More for your money « complete 
C-source code e single and multi-user 
capability ¢ no royalties e unlimited 
free technical support e port to all 
machines for one price. 


c-tree features e fixed and variable 

length data records e record locking 

e variable length keys and key 

compression e overcomes OS file 
and more. 


r-tree features e no printer spacing 
charts e change reports without 
recoding e unlimited control breaks, 
accumulators and virtual field calcu- 
lations e powerful search, select 


and sort capabilities over multiple 
saves days of coding. 


FairCom’s unmatched products will 
work for you. Order c-tree today for 
$395, r-tree for $295. When ordered 
together, r-tree is only $255. For 
VISA, MasterCard and C.O.D. orders 
call (314) 445-6833. For c-tree 
benchmark comparisons, write us at 


4006 West Broadway, Columbia, = es 
MO 65203. c-tree /r-tree 
e 
CIRCLE NO. 163 ON READER SERVICE CARD aN FairCom 
4006 W. Broadway Columbia, MO 65203 


UNIX is trademark of ATGT, MACINTOSH is trademark licensed to Apple Computer Company, 
VAX is trademark of DEC, TOWER is trademark of NCR, XENIX is trademark of Microsoft 
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800 phone number, and you can 
charge to plastic. 

2. If you're developing commercial 
products, try to become a certified 
Apple developer. Most important, 
this gives you access to Apple's elec- 
tronic-mail technical support. 
Within the corporate constraints, 
the remarkable tech support 
humans will help you work through 
most any problem. Answers come 
within 24 hours. Other certified de- 
veloper pluses: marketing assistance, 
developers’ conferences, discounts 
on development hardware, and a 





tinge of credibility. 

3. Get Inside Macintosh and its de- 
scendants. If the Pulitzers had a tech- 
nical writing category, Inside Mac 
would own a prize. Caroline Rose 
and her cohorts and descendants 
have given us the most comprehen- 
sive insight into a complex cyber- 
netic system yet seen. This is the 
starting point for all Macintosh pro- 
gramming. Take a look at the APDA 
newsletter for the latest volume 
count. The only flaw is a lack of 
practical examples, but other folks 
have filled that gap (see next item). 
4. Add at least the following five 
books to your library: Scott Knaster's 
How to Write Macintosh Software, 
Dan Weston’s The Complete Book of 
Macintosh Assembly Language Pro- 
gramming (Volumes I and II), The 
Best of MacTutor, and The Complete 
MacTutor. Other fine Mac program- 
ming books are available, but these 
five are classics. They give you the 
practical examples that Inside Macin- 
tosh lacks. And, if you share my lack 
of photographic memory, you'll also 
want some language references. I 
like the handy little Signetics S68000 
User's Guide for 68000 assembly lan- 
guage and Harbison and Steele's C: 
A Reference Manual. (Objectivity 
note: Dan Weston is a longtime 
friend and fellow traveler.) 

5. After you've reupped with DDJ, 
subscribe to MacTutor. It's one great 
Macintosh programming magazine, 
filled each month with nerdly little 
programming goodies. 

6. Put together an array of develop- 
ment tools. Plenty of good ones are 
available, and every now and then, 
I'll review some here in the column. 
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After all, I’m a language junkie; one 
of the perks of this gig is feeding the 
addiction guilt-free. 

Choosing development tools is 
pretty personal. With one exception 
(now justly dead in the market), I 
haven't hit a Mac programming tool 
that someone wouldn't find useful 
in some context. The Mac environ- 
ment must have some kind of inspi- 
rational effect. You'll have to follow 
the usual path to find personally 
amenable tools: talk to friends, read 
reviews, scan the ads, ask questions 
on the networks, play around. For 
what it’s worth, here’s a commented 
list of what I currently find myself 
using; note that most of my Mac 
work is done in C, with 68000 assem- 
bly language for speed tweaks and 
writing specialized code resources. 

®C compiler: Lightspeed C 2.11— 
blazingly fast, holds to standards, 
feels good. 

®68000 assembler: MDS 2.1—I 
started here and have found no 
reason to move on; now marketed 
as the Consulair 68000 Development 
System. 

® Debugger: TMON 2.8—clean, 
simple, powerful, can survive a lot 
of weirdness. 

® Text editor: QUED/M 2.04—solid, 
feature-packed, useful macro lan- 
guage, very nice. 

® Resource editor: ResEdit 1.1B1 
—one of the unsung great hacks, 
this Apple-produced program is the 
Mac-like way to create and manage 
resources. 

® Disk and file editor: Fedit Plus— 
does anything you can think of to 
disks and files, fast and accurate 
with a very clean interface. (Objectiv- 
ity note: I worked on the latest Fedit 
Plus documentation.) 

@Code snooper: MacNosy— 
allows intelligent examination of any 
piece of code you can specify, in- 
cluding and especially the ROM. (Ob- 
jectivity note: I worked on the [little 
yellow book] MacNosy documenta- 
tion.) 

7. Get a Mac with a hard drive and 
as much memory as you can afford. 
Anything less will drive you nutso 
fast. Hey, I oughtta know: I did my 
first Mac programming in assembly 
language on a 128K one-drive ma- 
chine with 8-minute turnarounds. 
With a language such as Lightspeed 

















SCSI machine, turnarounds drop 
down into the sub-30-second range. 


Useful Mail-Order Sources 
When I'm not traipsing around civili- 
zation as a cybernetic nomad, I live 
in the middle of nowhere, so I have 
to rely on mail-order sources to get 
programming books, software, and 
miscellaneous supplies. I've found a 
couple of good ones I'm happy to 
share with you. | 

For books, I use Computer Liter- 
acy. This bookstore carries just 
about everything, takes credit cards, 
and ships UPS the day you order. 
For software and supplies, I use Com- 








Add C++ to 
your favorite 
C Compiler 


¢ Object-oriented C 


e Strong type-checking 


¢ Works with your 
present C Compiler 






BENEFITS: 











& Makes C more Suitable for 
— very large programs 


& Works with Sun’s dbxtool 


now use 
> More reusable code 
> Resilient and bug-free code 





> You can incrementally add C++ 
features to C (switch-selectable) 


— more sophisticated applications 


& Works with the C Compiler you 


puterware. It specializes in the Mac, 
also takes credit cards and ships 
UPS quickly, and has an 800 phone 
number. Both these places have 
retail outlets well worth a visit if 
youre in Silicon Valley. 


Don’t Trash Your Old Mac 

Apple’s Macintosh upgrade path has 
been a little bumpy. A lot of folks 
still have 512s, possibly upgraded 
from 128s, and wonder whether it’s 
worthwhile doing any further up- 
grading. Here’s what I did: got 
Apple’s 800K drive/128K ROM up- 
grade ($300 at an Apple dealer), then 
added SuperMac’s Enhance board 





DESIGNER C+ - 


FEATURES: 
e Fully compatible with 
AT&T C ++ standard 
¢ Optional strong type 
checking 

e Data abstraction 

¢ Overloading of func- 
tion names and 
operators 

e Dynamic typing (virtual 
functions) 

e User-defined implicit 
type conversion 


The only commercially-available C++ customized 


to operate on PC's, micros, minis, and main- 
frames with popular C compilers, including: 


VAX C GREEN HILLS 
ULTRIX C APOLLO 

SUN C XENIX 
MICROSOFT’ HP-9000 
LATTICE UNISOFT 


We Specialize in: Cross/Native Com- 
pilers: C, Pascal, FORTRAN, Ada, LISP — 
Assemblers/Linkers — Symbolic Debug- 
gers — Simulators — Interpreters — Pro- 
filers — QA Tools — Design Tools —Comm. 
Tools —OS Kernels — Editors — VAX & PC 
Attached Processors and more 

We Support: 680xx, 80x86, 320xx, 68xx, 
80xx; Clipper, and dozens more 


‘Lattice and Microsoft versions of Designer C++ are known as 


Advantage C ++ 





60 Aberdeen Ave., Cambridge, MA 02138 (617) 491-4180 “=” 


ES 


1219 Morningside Drive, Manhattan Beach, CA 90266 (213) 546-5814 (CA only) 


Designer C++ is a joint trademark of XEL. Inc and Glockenspiel, Ltd of Dublin. Ada is a trademark of the U.S. Government (AJPO). Advan- 
tage C++ is a trademark of Lifeboat Associates. Inc. Other trademarks are acknowledged to DEC. Lattice. Microsoft & Sun Microsystems, Inc. 
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($500 installed at Fry’s Electronics). 
Enhance brings your Mac up to 2 
megabytes (expandable to 6.5 with 
high-capacity SIMMs), gives you a 
slight speed increase, and adds a 
SCSI port and a small internal fan. 

I had one problem with the para- 
sitic clip that plugs Enhance into 
the motherboard’s 68000, but Super- 
Mac kept Federal Expressing me re- 
placements until we had the prob- 
lem licked—no problems since then. 
I get a big grin on my face when my 
original 128K Mac comes up on a 
speedy hard disk with megabytes of 
RAM at its disposal. 


Lightspeed C 
It's hard to hold in my feelings on 
this product. Let’s just say this: I 


Standard Button | 


Standard Button 
MECN aime cil) 





Figure 1: Standard button in its 
three highlighted states—inactive, 
active, and highlighted 
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love it. Michael Kahl and the rest of 
the Think Technologies crew have 
given us something wonderful. This 
thing is fast—makes me want to 
stick some flame decals on the Mac. 
Working in the LSC environment’s a 
tasty treat, and I for one refuse to 
go back to anything slower or less 
capable. 

Producing robust Mac code is (for 
me, at least) a highly iterative proc- 
ess. It bears repeating: Mac software 
exists in a very dynamic universe. 
The slightest coding miscue quickly 
propagates into screen-twisting mad- 
ness. Debugging is_ tricky—well 
worth avoiding—so I like to write 
my code in snippets, testing and 
debugging each piece thoroughly 
before moving ahead. Lightspeed C, 
with its blazing turnaround speed, 
lets me do this painlessly. 

A lot of attention’s been paid to 
the product's details. Work goes on 
in a well-integrated project environ- 
ment. Nitty litthe maintenance de- 


tails are automated. The language, — 


libraries, and header files hold 
closely to the relevant standards 
(Unix, Kernighan & Ritchie, Harbi- 
son & Steele, the evolving ANSI C, 
and Inside Macintosh). The editor's 
good—not quite so feature-laden as 
QUED/M but good—with powerful 
grep capabilities. The compiler puts 
out code that’s fast and compact. 
It's easy to produce the various sorts 










inversion 


inversion 









inversion 







Figure 2: RectCDEF's 16 button variations 
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of Macintosh code, with global and 
Static variables available in each: 
double-clickable applications, desk 
accessories, device drivers, and code 
resources. In-line assembly-language 
code’s allowed, with full access to 
the C name spaces. Resource file 
management is completely auto- 
mated. Register variables are maxi- 
mal: five data registers and three 
address registers. HFS and MultiFin- 
der are well supported. 

I recently had the pleasure of 
spending a September afternoon at 
Think headquarters doing free-form 
nerd talk with Michael Kahl (the 
prime Lightspeed C programmer), 
Andrew Singer (head of Think and 
coconceiver of Lightspeed), and 
Doreen Duplin (marketing/communi- 
cations whiz). These are nice people 
in whom the joy of the great hack 
runs deep. Interesting backgrounds: 
Michael was a philosophy grad stu- 
dent before succumbing to the lure 
of machine logic. Andrew's known 
to many of us for his classic (and, 
sadly, out of print) Sherlock Holmes 
pastiche programming books Elemen- 
tary BASIC and Elementary Pascal. 

Recent releases of both Lightspeed 
C and Lightspeed Pascal (2.13 and 
1.11A, respectively, as this column is 
written) have been maintenance re- 
leases, keeping the languages cur- 
rent with the latest Mac machinery 
and system software. In the works, 
though, are major new releases of 
both languages. Look for greater 
speed and, for Lightspeed C, power- 
ful debugging capabilities. “It’s time 
for another dose of the spectacular,” 
quoth the Singer. 

I wish I had room to give you a 
complete transcript of the after- 
noon's conversations. The Thinkers 
said a lot of smart stuff. Maybe in a 
future column. Meanwhile, take this 
as a bottom line: if you program the 
Mac in C, check out Lightspeed. 


Code Corner 
All right, time to get down to a little 
code hacking. My first project in- 
volves writing and using a custom 
control definition. Because of space 
constraints, I'll describe the project 
in two phases, continuing the dis- 
cussion in next month’s column. 
Macintosh applications are rife 
with controls: buttons, scroll bars, 
check boxes, radio buttons, et al. 
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C-Worthy Interface Library helps you smoothly pull together all aspects of an excellent Human Interface. 


C Programmers: Wrap an Exciting, 
Bullet-Proof Interface Around 
Your Code Quickly. 


Introducing... 
C-Worthy® Interface Library 


The only human interface package 
you need. That’s what our customers 
are telling us. One early adopter, 
Novell, Inc. uses it exclusively in the 
development of their NetWare® 
Utilities, which reach over 500,000 
users. You see, C-Worthy Interface 
Library is the only library available to 
handle every aspect of your program’s 
human interface, all in one package. 
Now your programs will have a 
consistent look and feel. You no longer 
have to integrate pieces of libraries 
from different manufacturers. 

As important as you know users are, 
you often don’t have the time to heavily 
invest in writing routine code. And 
that’s OK, because with over 400 tight, 
ready-to-use functions, C-Worthy 
Interface Library takes care of the 
tedium and lets you spend your time 
doing what you enjoy. Concentrate on 
the heart of your application — features 
that make it unique, special. Let 
C-Worthy Interface Library do your: 

@ Menus 

e Error Handling 

e DOS Interface 

e Context Sensitive Help 
e Screens, Windows 

e Forms, Data Input (optional 


You control color, size, border, 
location, etc. And if there’s anything 
you want to change, you can. Source is 
available to provide you with the 
flexibility you need. And you can 
distribute your applications freely, with 
no royalties. 


C-Worthy Interface Library requires hard disk media with 256K 
RAM. MSDOS 2.0 + and IBM PC, or compatible, TI Professional, 
NEC APC Il, or VICTOR 9000. C-Worthy is a registered 
trademark of Custom Design Systems, Inc. 









Tech Specs 

™ Compilers: Microsoft 3.0+, Quick, Turbo, 
Lattice. All models. 

w= 350+ functions written in C, 75+ in 
Assembler. 

z= Menus: Fully support pop-up, Lotus style, 
MS Windows style (pull-down), pull-up. 

> Errors: DOS, program, and user. 

mw DOS Interface: 62 functions. File handling, 
dir. and drive management, date & time 
conversion, wildcards, more. 

2 Help: System and context sensitive. 

zw Screens: Screen display, color palettes, save, 
restore, scroll, more. 

> Windows: Exploding, tiled, pop-up, 
overlapping. Direct video access and virtual. 
Up to 50 active at any time. 


mw Keyboard Handling: Regular, function, 
interrupt, background procedures. 













w> Editing: String and word wrap text. 

= Form Interface Library: 118 functions. 
Over 15 field types, and user definable field 
types. 3 levels of data validation: type, 
multiple field ranges, optional validation 
procedures. Hide, lock, or secure a field. 
Optimal field movement. 

> Foreign Languages: All text messages in 
separate files for easy translation. 


= Compatible with MS Windows. 
 OS/2 special overlay when released. 


wz Machines: Autodetect for MDA, CGA, 
EGA, VGA, TI, AT&T, Victor. 


w No royalties. 
















“T heartily recommend this package.” 
— David A. Schmitt, president, Lattice, Inc. 
Over 400 developers in 16 countries already use it. 


Thorough Documentation 


Indexed alphabetically and by category, 
the 700+ page Reference Guide includes 
for each function: an example, description, 
calling conventions, return values, and 
related functions. The 250 page User’s 
Guide gets you going with its tutorial 
and “Getting Started” sections. 
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“C-Worthy is a comprehensive C library whose 
time has come. I heartily recommend it as your 
next purchase.” —Computer Language, 8/87 


gates: sl 
interface Library 





C-Worthy Interface Library: 


Object only ..................... $ 195 
Form Interface Library add-on..... $ 100 
Object with Forms ............... $ 295 


Object with Forms & Library Source. . .$ 495 


Please specify compiler and version when ordering. 





To Order Call 


(800) 821- 2492 
in MA (617) 337-6963 


Solution 
ystems 

541-D Main Street, Suite 410 
South Weymouth, MA 02190 
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Definitions for standard controls are 
built into the Mac ROM/OS—there’s 
the standard button, for example. 
Clicking a standard button with the 
mouse makes things happen. Stan- 
dard buttons have three basic states, 
each with a corresponding visual 
metaphor: inactive, when the button 
won't respond to a mouse click; 
active, when the button will respond 
to a mouse click; and highlighted, 
when the button’s in the midst of 
being clicked. Figure 1, page 94, 





shows a standard button in each of 





these three states. 

But you also have the ability to 
define, via a CDEF code resource, 
your own buttons. The CDEF re- 
source can then be incorporated 
into an application and can be 
called upon whenever the applica- 
tion wants to put a button on the 
screen. Custom CDEFs are not very 
difficult to write and can provide a 
lot of flexibility at low memory cost. 
The CDEF I'll be showing you in this 
column, for example, is less than 
1,400 bytes long yet it provides 16 
new types of buttons—that’s less 
than 88 bytes per button variation. 
Such a deal. 


If You Have Turbo C You Have 
Half Your C-Programming Vehicle 

















Turbo C is a great compiler b 
one vital cog missing — deb 
Without it, you have to spenc 
lot of energy to go a short di 


Gimpel Software’s C-terp, lor 
nized as the leading C interpr 
fully supports Turbo C w 
plete compatibility guara 


Interactive Debugger — Ou 
debugging facilities include s 
screen (code in upper portion 
dialog in lower), breakpoi 
(sticky, temporary, line/fun 
directed), display of structure 
execution of any expression (even those 
involving macros), function traceback 
with arguments, watch expressions and 
watch conditions (watchpoints). Our 
watch expressions can be structs or 
arrays. We catch out-of-bounds pointers! 


No Toy — Full K&R with ANSI enhance- 
ments. Multiple-module with a built-in 
automatic make. It has virtual memory 
option (with optional direct use of ex- 
tended memory) and a shared symbol 
option for those big programs. It supports 
graphics, dual displays and the EGA 
43-line mode. 


Links to external libraries — (both code 
and data, automatically) which can call 
back to interpreted functions. Function 
pointers are compiler compatible. 


100% Turbo-C compatible. —Same 
header (.h) files, data alignment, bit field 
orderings and preprocessor variables as 
your compiler. We link in your com- 
piler’s library. 


Our reconfigurable editor — is multifile 
and comes with a configuration script to 
mimic Turbo’s editor. 
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The missing silat that will 
turn your half-cycle into a bicycle 


C-terp 


Order C-terp today! 
Call (215) 584-4261 


Introductory Price for Turbo C-terp: 


$139.00 


VISA, MC, COD — 30 day money back 
guarantee 


C-terp Version 3.0 is also available for the 
following compilers: 

Microsoft, Lattice, Aztec, C86, and Mark 
Williams ($298) and Xenix ($498). 





CIMPEL SOFTWARE 


3207 Hogarth Lane 
Collegeville, PA 19426 


C-terp is a trademark of Gimpel Software. and Turbo C of 
Borland International. 





Development Details 

I wrote my CDEF, called rectCDEF, 
in assembly language using MDS 2.1. 
That’s because I wanted high execu- 
tion speed and small code size. I 
wrote a demo application in C that 
shows off the 16 button types using 
Lightspeed C 2.11. Resources for the 
application were put together with 
ResEdit 1.1B1. PICTures for particu- 
lar buttons were drawn in 
SuperPaint 1.0p, then transferred 
into ResEdit via the Scrapbook. 

I first got the demo application 
up and running, albeit with just one 
control, that being of button vari- 
ation 0 (see later). Then I started 
work on the CDEF. As I worked on 
the CDEF, I used an Exec JOB file to 
assemble the code, link it, turn it 
into a resource, then merge that 
resource into the demo application 
for testing. I worked on one vari- 
ation at a time, adding a control of 
that type to the demo application, 
then fixing the CDEF to cover that 
case. 

Any particular CDEF can have up 
to 16 variations. (Actually, you can 
hack in a few thousand, but that 
technique’s for another article.) | 
used’ all 16 in rectCDEF. The 
rectCDEF buttons live in a rectangu- 
lar world. A particular button vari- 
ation can contain text, a picture, or 
an icon. Text can be in any font/size/ 
style combination the Mac's capable 
of. A button variation can have a 
simple outline, a shadowed outline, 
or (unless it’s a text variation) no 
outline. A button variation can indi- 
cate highlighting via inversion or a 
change of content. 

Figure 2, page 94, details the 16 
rectCDEF button variations. Figure 
3, page 98, shows examples of each 
variation, with pictures of the active 
and highlighted states. 


An Overview 
The demo program, imaginatively 
named custom controls demo, puts 
up a modal dialog containing exam- 
ples of rectCDEF buttons, then re- 
sponds to button clicks. Figure 4, 
page 100, is a screen snapshot of the 
program's modal dialog. Using a 
modal dialog simplified the pro- 
gram’s event-handling logic; it's a 
nice technique for bench testing 
new routines. 

Figure 5, page 100, shows the files 
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Third generation Ada Is here today with Meridian 
AdaVantage, and it’s validated by the Department 
of Defense and their suite of 2,700 tests. Ada’s first 
generation was the proving ground technology of 
the early eighties. Then came the large validated 
compilers of the mid-eighties, which were often 
inefficient and machine specific. Now Meridian 
offers a compact efficient Ada technology that is 
highly portable from PC’s to minis to mainframes. 


COMPACT MERIDIAN Ada IMPLEMENTATION 


350,000 


Lines of 
Source 
Code 


40,000 





Meridian Other Ada Compilers 


The chart above depicts the dramatic difference 
between Meridian’s implementation and other 
comercially available Ada implementations. 
Meridian’s order of magnitude smaller code size 
results in an extremely fast compiler that will 
produce highly optimized code. 


Meridian’s Track Record 


Since 1981, we've been building compilers the old- 


fashioned way, through hard work and experience 
gained from our development of successful 
portable compiler products. These products are 
installed at over 1,500 sites, including almost all 
major DoD contractors as well as commercial 
software developers. 


uD 
Ada 


THIS PRODUCT CONFORMS 
TO ANSI/MIL-STD-1815A AS 
DETERMINED BY THE AJPO 
UNDER ITS CURRENT 
TESTING PROCEDURES 


THE ADA WORLD 
HAS GHANGED. 


Next Generation Ada Technology 





Price/Performance Breakthrough 


The Meridian AdaVantage v2.0 validated Ada 
compiler costs $795 and provides a production 
quality Ada development tool. 


SIEVE BENCHMARK 


Meridian 20: of Aleve vig, 


NOTE: All times measured on an !1BM at 5170 (8MHz) and a 4MB RAM card 
required by the Alsys system. When running without the RAM card, the 
Meridian compile and link time is 46 seconds. 









The Meridian AdaStarter incorporates all of the 
features of AdaVantage, with certain size 
limitations. AdaStarter is perfect for anyone who 
wants to learn how to program in Ada. The 
complete $99 cost is applicable toward the 
purchase price of the AdaVantage production 
compiler. 


The compilers all run in a standard PC 
configuration with 640K of memory, a hard disk, 
and DOS v2.1 or higher. 


To order today, or get more information, call 
1-800-221-2522 (outside California) and 
1-714-380-9800 (inside California). 


“The Meridian compiler is a very well-thought-out 
compiler. The compiler is fast and execution speed 
is more than adequate... Overall, we’d rate the 


Meridian compiler as very solid.” 
— COMPUTER LANGUAGE, DECEMBER 1986 


“The more affordable AdaVantage v1.0 is good for 
the average programmer because of its price, the 
extent of its implementation, and its relaxed 
hardware requirements... [AdaVantage v2.0] should 
be competitive with Alsys Ada, since it will be a full 
Ada at less than a third of the price of Alsys.” 


BYTE, JULY 1987 
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23141 Verdugo Drive, Suite 105, Laguna Hills, CA 92653 
800/221-252 (outside CA) 714/380-9800 (inside CA) 
Telex: 650-268- Bey MCI Fax: 714/380-1683 
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TO THE MACS demo.c (see Listing One, page 54); 
(continued from page 96) and MacTraps, the LSC library that 
a ee iio ine Mac Kiwis 
| involved in the demo program. | (see Figure 6, page 100). Custom con- 
Custom controls demo PROJ is an | trols demoh, in Listing Two, page 
LSC project file that contains the C | 64, is a file of private definitions for 
source code file; custom controls | custom controls demo.c. Custom con- 


trols demo PROJrsrc (available on 
CompuServe and the DDJ listings 
disk) is a collection of program re- 
sources, including rectCDEF, that 
gets bound into the final applica- 
tion. It was put together with Res- 
Edit. Finally, custom controls demo 


Variation 0 Variation 1 


Variation 4 
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Save File As... 


Save File As ... 








Figure 3: Samples of the 16 rectCDEF variations in active and highlighted states 
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DEBUGGING SWAT TEAM — 


Order Eco-C88 Rel. 4.0 New Modeling Compiler _— Ba 
and get C-more at no extra charge! ~#HHO. = 


Seek and Correct 


You already know that fast compilation does not mean fast program development. Backing 

up for bogus error messages and removing the bugs takes time. Eco-C88’s “Seek and Correct” 
three - way error checking finds even the most elusive bugs, clearing the path for swift program 
development. 


Double Barrel Error Checking 


Eco-C88 nails cold and tells you about the error in plain 
English. And there’s no avalanche of false error messages, either. Other 
compilers can generate up to four times the number of error messages 
actually present; they leave it up to you to guess which ones are 

real. You'll be more productive with Eco-C88 because there is no 
guess work. 


Eco-C88 provides ten levels of checking. You can 
select from almost no checking to the fussiest you’ve ever seen. 
Eco-C88's “picky flag” finds subtle errors that slip by 

other compilers. 





Eco-C88 also features: 


e All data types, plus ANSI Enhancements 
e Robust library, including many new ANSI 
functions 

e CED editor with online function help, split 
windows, compile-edit-link capability 

@ New, expanded manual with sample pro- 
grams for the library functions 


C-more Source Code 
Debugger 


Finally, if a really nasty bug persists, 
put C-more, our source code debug- 
ger, to work. With C-more you can 
watch your program as it executes, 
single-step it, set simple or conditional ) 
breakpoints, test complex expressions, ue — =—=s 
use variables as indexes into other vari- 

ables, initialize and trace variables, examine 

CPU registers, display results with printf()- 

type options and much more. C-more can help 
you track down bugs in minutes rather than days. 


The price for Eco-C88 is $99.95. And, for a 


limited time, we'll give you our C-more debugger 
at no extra charge. 


Ecosoft Inc. 
6413 N. College Ave. 
Indianapolis, IN 46220 


(317) 255-6476 (Tech Info) 
(800) 952-0472 (Orders) a 
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TO THE MACS 
(continued from page 98) 


is the double-clickable final applica- 


tion. 

Although it’s small and simple, 
custom controls demo.c follows the 
classic pattern of Macintosh pro- 


Turn Off Some Buttons 
i's 





grams. First come a few setup activi- 
ties. Then the program sits in a 
main event loop, waiting for events 
of interest. When such an event 
occurs, the program figures out 
what’s up, acts appropriately, then 
returns to the main event loop. At 
some point an event occurs that 


©1987 Stan Krute 
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Turn On Some Buttons 


Figure 4: Custom control demo's main modal dialog 


custom controls demo 
18.4SSH in disk 


custom controls demo.h 


custom controls demo PROJ.rsrc 





custom controls demo 


Figure 5: Five files used by Lightspeed C to build the program custom 


controls demo 



















Figure 6: The LSC project file used to build custom controls 
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tells the program to pop out of the 
main event loop. Then come a few 
cleanup activities, followed by an 
exit to the OS shell. 

Each control button in custom 
control demo’s main modal dialog 
has a corresponding item number 
in the DITL resource that supplies 
the dialog. Figure 7, page 101, 
matches each item with its DITL 
item number. These numbers are 
given symbolic names in the header 
file custom control demo.h. The 
same numbers are used for the 
CNTL template resources that each 
DITL item points to. 


A Few Function Notes 

If you've done your homework, the 
demo program should seem trivially 
simple, so I won't go into massive 
descriptive detail. That'll get saved 
for next month when it’s time to 
cruise the rectCDEF assembly-lan- 
guage code. Here are a few notes: 


main—Sets up the Mac managers, 
gets the modal dialog going, runs 
the main event loop, then cleans up 
and exits when all is done. Note the 
substitution of the ROM call Mod- 
alDialog for the usual GetNextEvent 
as the heart of the program's main 
event loop. 


inititializeManagers—Grabs some 
master pointers, forces the heap to 
grow and clean itself, gets the ROM/ 
OS managers up andé= running, 
flushes the event queue, and brings 
up the standard arrow cursor. 


studyAndSetEnvironment—Figures 
out the size of the screen and menu 
bar. This information is used later 
on to position windows neatly. 


getThatDialogCookin—Brings _ the 
main modal dialog into memory, po- 
sitions it on the screen, sets its font 
to Geneva 12, then makes it visible. 
Note well: it’s a good idea to use 
dialog and window templates that 
come up invisibly. Then you can 
bring them into memory, pull off 
any adjustments in private, and use 
ShowWindow to make them appear. 


dealWithDialogitem—Just a_ big 
switch statement to case out on the 
button that got clicked in the main 
event loop. The top layers of a Mac 
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application are usually filled with 
such switch statements as the pro- 
gram zeroes in on exactly what kind 
of event occurred and what to do 
about it. Note how the guitItem 
button controls the main event loop 
via the global Boolean variable fin- 
ished. 


The following nine routines deal 
with the clicks of specific buttons: 


doOrwellltem—tThe orwellltem but- 
ton stays highlighted while the 
ronitem button fades in and out. 


doSnapshotItem—The doSnapshot- 
Item button lets you take action pic- 
tures of the demo program via a call 
to a Camera desk accessory. If you 
don't have such a DA in your system 
file, the OpenDeskAcc call returns 
without crashing. 


doMushroomItem—Similar to doOr- 
wellltem. This time the bumperStick- 
ersItem fades in and out of view. 


doOpenItem—Calls on the standard 
file-opening routine, then does noth- 














FAST Languages 


through a little animation routine 
by turning highlighting on and off. 


ing with the routine’s result. 


doSaveAsItem—Calls on the stan- 
dard file-saving routine, then does 
nothing with the routine’s result. 


doSomeOffltem—Takes a list of but- 
tons and makes them inactive. 


doSomeOnItem—Takes the same list 
of buttons passed to doSomeOffItem 


doFlipItem—Takes a list of content- 
changing buttons, then runs them 
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Figure 7: DITL item numbers for each of the controls in custom control 
demo's main modal dialog 






jor UNIX Systems 


Philon’s powerful suite of UNIX program- 
ming languages delivers fast execution of 
applications. Through a compiler design 
so unique it’s patented, Philon languages 
optimize code so that it’s as efficient 


as can possibly be. 


Philon compilers are compatible with indus- 
try standard languages. And they conform to 
ANSI and FIPS standards to satisfy GSA 


requirements. 


PHILON FAST/BASIC-M® PHILON FAST/ 
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COBOL® and PHILON FAST/FORTRAN® are 
now available for most 68000/UNIX™ sys- 
tems such as the Unisys 5000 series, NCR 
Tower, Arete 1100, Harris MCX, and Sun II. 
They are also available for VAX/ULTRIX® 
systems, including the MicroVAX II, and 
the AT&T 3B2/400. 


To get the full story on PHILON FAST/ 
COMPILERS, and a reprint of our article, 
“Optimizing Compilers Decrease Native 
Code and Speed Execution,” from Computer 
Technology Review, call or write: 


PHILON 


641 Avenue of the Americas, New York, NY 10011 
1-800-443-5748 


In NY 212-807-0303 
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PROGRAMMER’S PARADISE PRESENTS 


C Tools . 


Power Tools for 


Serious Programmers 


If you are serious about developing C programs faster and 
more efficiently, Phoenix offers the high performance tools 


you need. 


Professional programmers worldwide rely on Phoenix tools 
to more quickly write, test and deliver the tightest, clean- 
est C applications possible. Power tools. Tools like Plink® 
86plus and PforCe;" which are established industry 
standards, and Pfinish™ and Pre-C*"which are today’s 


best kept programming secrets. 


Programmers rate Phoenix tools as superior for many rea- 
sons. Performance. Ease of use. Flexibility. Integration with 
other Phoenix tools. The bottom line is that all Phoenix 
tools are engineered to enhance the way you work. 


@ Features two fully detailed manuals. 





® Contains over 400 pre-coded, optimized, 
object-oriented C routines. 


= Includes databases with B-trees, windows, 
interrupt-driven communications, string han- 
dling, menus, all of the basic DOS interfaces, 
and a complete set of low-level functions to 
interface directly to the hardware. 


= Comes complete with indexed reference 
manual, on line resident help, and quick 
reference card. 


= Supports all memory models of the following 
C compilers: Lattice, Aztec, Microsoft, Cl-86, 
and Wizard. 

@ Includes full source code. 

® No royalties on generated applications using 
the libraries. 
List: $395 Ours: $209 


& Now twice as fast! 





®@ Cross-checks multiple source files and 
libraries at once. 


® Reports incorrect, obsolete, and non-portable 
C usages. 


= Uncovers errors in interfaces between 
program modules. 

® Accepts full UNIX System III C syntax as well 
as ANSI proposed extensions. 


mw Uses external libraries with or without 
source code. 

@ Includes libraries for the latest releases of 
the Mark Williams, Lattice, CI-86, Microsoft, 
Wizard, and Aztec “C” compilers. Supports 
all memory models. 

List: $295 Ours: $155 


= Special Pre-C and PforCe combo pack 
List: $495 Ours: CALL 


@ Helps “fine-tune” programs by identifying 
inefficient sections of code that need to be 
written for maximum performance. 


= Analyzes programs during execution. 


m Produces reports and histograms that give 
a snapshot of which routines were reached, 
their callers, number of executions, amount 
of time spent in each, number of instructions 
executed in each, and more. 


@ Writes histograms and tabular reports, sorted 
by address or symbol, in any page width or 
height, to a file, the console, or the printer. 
Uses symbol table information to produce 
meaningful analyses on overlays and 
interrupts. 


List: $395 


Ours: $209 





Plink® 86plus 


= The only linkage editor containing advanced 
overlay capabilities. 


= Handles any compiler or assembler producing 
standard Intel or Microsoft OBJ files. 

= Ensures sample capacity for symbol and 
common block names (nearly 33,000). 

= Supports an unlimited size file, an unlimited 
number of modules and up to 4,095 overlays 
nested up to 32 deep. 

= Merges object modules, caches overlays in 
extended or expanded memory, and automati- 
cally reloads overlays upon function return. 

@ Includes Plib86 object library manager. 
List: $495 Ours: $275 
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m The only C++ library available on the 
IBM PC. 


= Provides everything necessary to build 
complete applications. 

® Contains high-level classes like windows, 
databases, B-trees, fields, menus, rings, lists, 
communication tasks, time/date stamps. 

® Includes both high-level object classes and 
low-level hardware, BIOS and DOS access; 
complete source code to libraries with no 
royalty; disk management, archiving, com- 
pilation, and library management utilities 
supplied in both executable and source 
form; and overridable functions with rea- 
sonable defaults. 


List: $395 Ours: $209 


Find out why so many 
programmers rely on 
Phoenix for high 
performance, 


1-800-445-7899 
In NY: 914-332-4548 


2 Programmer’ 
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Programmer’s Paradise Gives You Superb Selection, 
Personal Service and Unbeatable Prices! 


Welcome to Paradise. The microcomputer software source that caters to your programming needs. 
Discover the Many Advantages of Paradise... 
® Lowest price guaranteed ® Huge inventory, immediate shipment ® Special orders 
© Latest versions ® Knowledgeable sales staff ® 30-day money-back guarantee 


Over 500 brand-name products in stock —if you don’t see it, call! 





We'll Match Any Nationally Advertised Price. 











LIST OURS LIST OURS LIST OURS 
386 SOFTWARE MICROSOFT C 450 269 REPORT OPTION/N 345 269 
ADVANTAGE 386 C 895 799 QUICK C CALL-REBATE OFFER 99 65 C-TREE 395 315 
ADVANTAGE 386 PASCAL 895 799 TURBOC 100 65 R-TREE 295 239 OPERATING SYSTEMS 
MICROPORT.SYSTEM C-TREE/R-TREE BUNDLE 650 519 MICROPORT SYSTEM V/AT 
V/386 (COMPLETE) SPECIAL 799 679 C INTERPRETERS DBC Ill 250 169 (COMPLETE) 549 475 
MICROSOFT WINDOWS /386 195 125 C-TERP 298 219 DBC III PLUS 750 595 SCO XENIX SYSTEM V 
PHARLAP 386|ASM/LINK 495 419 INSTANT C 495 369 INFORMIX PRODUCTS CALL CALL (COMPLETE) 1295 995 
PHARLAP 386 DEBUG 195 155 RUN/C 120 79 PHACT MANAGER 249 219 WENDIN-DOS 99 79 
SCO XENIX SYS V 386 (COMPLETE) 1495 1195 RUN/C PROFESSIONAL 250 155 XQL SPECIAL, NEW 795 599 OTHER MICROPORT, SCO, 
VM/386 SPECIAL 195 119 WENDIN PRODUCTS CALL CALL 
X-AM 595 535 C LIBRARIES EDITORS 
BASIC_C 175 129 BRIEF 195 CALL PASCAL COMPILERS 
ARTIFICIAL INTELLIGENCE C ASYNCH MANAGER 175 135 W/DBRIEF 275 CALL MARSHAL PASCAL 189 155 
ARITY STANDARD PROLOG 95 79 C-FOOD SMORGASBORD 150 95 CVUE W/SOURCE CODE 250 199 MICROSOFT PASCAL 300 185 
MICROSOFT LISP 250 155 W/SOURCE CODE 300 179 EDIX 195 155 PASCAL-2 350 329 
PC SCHEME 95 85 C/PAC (PFORCE, PRE-C) SPECIAL 495 CALL EMACS 295 265 TURBO PASCAL NEW V. 4.0 100 65 
SMALLTALK/V NEW’V. 2.0 99 79 C TOOLS PLUS/5.0 129 99 EPSILON 195 149 TURBO PASCAL DEV. LIB. NEW 395 259 
TURBO PROLOG 100 65 C UTILITY LIBRARY 185 119 KEDIT 125 99 BORLAND ADD-ONS CALL CALL 
TURBO PROLOG TOOLBOX 100 65 C-XPERT 295 249 LMK 195 139 
ESSENTIAL COMMUNICATIONS 185 119 PC/EDT 250 229 SCREEN DISPLAY/WINDOWS 
ASSEMBLERS/LINKERS COMMUNICATIONS PLUS 250 189 PC/VI 149 109 C-SCAPE 279 265 
ADVANTAGE DISASM. SPECIAL 295 249 GREENLEAFCSAMPLER SPECIAL 95 69 Pi EDITOR SPECIAL, NEW 195 149 CURSES W/SOURCE CODE 250 169 
ADVANTAGE LINK 395 359 GREENLEAF COMM LIBRARY 185 125 PMATE 195 109 GREENLEAF DATA WINDOWS 225 155 
ASMLIB 149 125 GREENLEAF FUNCTIONS 185 125 SPF/PC 195 145 W/SOURCE CODE 395 269 
EZ_ASM 70 65 MULTI-C 149 135 VEDIT PLUS 185 129 HI-SCREEN XL 149 119 
MS MASM REBATE 150 95 PFORCE 995 209 XTC 99 79 JYACC FORMAKER 495 449 
PASM86 195 109 RESIDENT C W/SOURCE 198 149 JYACC JAM 750 679 
PLINK86PLUS 495 275 TIMESLICER 295 265 FORTRAN COMPILERS MICROSOFT WINDOWS 99 65 
RELMS CROSS ASSEMBLERS CALL CALL W/SOURCE CODE 1000 895 LAHEY FORTRAN 477 CALL MS WINDOWS DEVELOPMENT KIT 500 309 
UNIWARE CROSS ASSEMBLERS CALL CALL TURBO C TOOLS 129 99 LAHEY PERSONAL FORTRAN 77 95 89 PANEL PLUS 495 395 
VISIBLE COMPUTER 80286 100 89 MICROSOFT FORTRAN 450 269 PANEL FOR QUICKC / TURBO C 129 95 
COBOL RM/FORTRAN 595 479 QUICKSCREEN 195 175 
BASIC E-Z PAGE NEW 295 259 SCREEN ACE 195 159 
DB/LIB 99 89 MICRO FOCUS PRODUCTS CALL CALL FORTRAN UTILITIES/LIBRARIES SCREENSTAR W/SOURCE 198 155 
FLASH-UP 89 79 MICROSOFT COBOL 700 439 DIAGRAM’ER/DOCUMENT’ER 129 115 VITAMIN C 225 159 
MACH 2 75 59 MICROSOFT SORT 195 129 DIFF-E-Q 495 445 VC SCREEN 99 79 
MS QUICKBASIC REBATE 99 65 OPT-TECH SORT 149 99 FORTLIB 125 109 VIEW MANAGER 275 199 
QUICKPAK 69 59 REALCICS 995 785 FORTRAN ADDENDA 165 139 WINDOWS FOR DATA 295 235 
TRUE BASIC 100 69 REALIA COBOL 995 785 GRAFLIB 175 169 ZVIEW 245 169 
TURBO BASIC 100 65 W/REALMENU 1145 899 GRAFMATIC/PLOTMATIC 135 119 
DATABASE TOOLBOX 100 65 RM/COBOL 950 759 MATHPAC 495 445 
EDITOR TOOLBOX 100 65 RM/COBOL-85 1250 999 NO LIMIT 129 115 
TELECOM TOOLBOX 100 65 RM/SCREENS 395 315 SSP/PC 350 269 
- SCREENIO 400 379 
GRAPHICS 
DEBUGGERS ADVANTAGE GRAPHICS (C) 250 225 
ADVANCED TRACE-86 175 115 ESSENTIAL GRAPHICS 250 185 
C-SPRITE 175 119 GSS GRAPHIC DEV. TOOLKIT 495 375 
PERISCOPE I 345 279 HALO 300 205 
PERISCOPE II 175 139 HALO (5 MICROSOFT LANG. ) 595 389 
PERISCOPE III 8 MHZ 995 799 METAWINDOW PLUS 275 229 
PERISCOPE III 10 MHZ 1095 899 TURBOWINDOW/C 95 79 
PFIX 86 PLUS 395 209 TURBO HALO (FOR TURBO C) 100 79 
T-DEBUG PLUS 60 49 
XVIEW86 60 49 LINT ADDITIONAL PRODUCTS 
PC-LINT 139 we aaetoe VCMS a2 oe 
DISK/DOS/KEYBOARD UTILITIES PRE-C 295 5 
BACK-IT 100 89 CARBON COPY PLUS NEW 195 139 
BOOKMARK 100 79 MODULA-2 DAN BRICKLIN’S DEMO PROGRAM - = 75 59 
COMMAND PLUS 80 69 FARBWARE MODULA-2 90 79 DB2C 299 CALL 
DISK OPTIMIZER 60 55 LOGITECH MODULA-2 FLOW CHARTING II 229 205 
INTELLIGENT BACKUP 150 135 COMPILER PACK 99 79 MAGIC PC 195 179 
NORTON COMMANDER 75 55 DEVELOPMENT SYSTEM 249 CALL MKS TOOLKIT 139 115 
ADVANCED NORTON UTILITIES 150 99 TOOLKIT 169 139 NORTON GUIDES 100 65 
C++ PDISK 145 99 WINDOW PACKAGE 49 39 PFINISH 395 209 
ADVANTAGE C++ 495 479 ROM PACKAGE AND CROSS POLYMAKE 149 125 
PFORCE++ 395 209 FILE MANAGEMENT RUNTIME DEBUGGER 299 239 POLYTRON PVCS CALL CALL 
BTRIEVE 245 185 REPERTOIRE 89 75 SOURCE PRINT 95 15 
C COMPILERS XTRIEVE 245 185 TREE DIAGRAMER a 69 
C86PLUS 497 375 REPORT OPTION 145 99 TURBO PASCAL ADD-ONS le 
HIGH C 595 CALL BTRIEVE/N 595 455 ALICE 95 69 
LATTICE C 500 265 XTRIEVE/N 595 455 DOS/BIOS & MOUSE TOOLS 75 69 
sa reas r= FLASH-UP 89 79 
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4 Keasons 
Why the MKs Toolkit Is a 
Very Large Package for a Small Price: 


It contains the UNIX full-screen editor VI/EX 
— and handles the various national character sets provided with DOS, as 
e well as 8-bit data and improved support for EGA and colour attributes. 


It comes with a complete KORN SHELL 
— a programming language in itself including vi and emacs command- 
line editing mode. 





It has the only version of AWK available under DOS 

— written to the latest Bell Labs specifications for System V.3, allowing 
multiple-subscripted arrays; awk is an excellent fourth generation lan- 
guage that even non-programmers will find readily accessible. 


Besides all this it comes with over 110 commands 

— including init, login, passwd, and who to facilitate multiple users of 
the same machine, or multiple application environments; pr and fmt for 
formatting files; crypt for file encryption; pack, unpack, and pcat for 
data compression; and the familiar commands such as: cat, cpio, date, 
diff, du, find, grep, head, Ic, od, pg, sed, sort, tail, tr, wc, and much 


| All for $139. 


Other MKS products available for DOS: 


MKS RCS (Revision Control System): Using MKS RCS, programmers, systems adminis- 
trators, project managers, and software librarians can efficiently control and record 
the revisions of text files such as programs, documentation, graphs, papers, form 
letters, and so on. It maintains a complete history of changes, including date and time 
of change, author, and reason for the change, and allows retrieval of any version of the 
file, by date, release number, or a user-assigned name. 

Now available separately: 
MKS AWK: The 4th generation language fully compatible with the latest description in 
The AWK Programming Language, by Aho, Weinberger, and Kernighan. MKS AWK with 
tutorials and documentation: $75. Both the software and The AWK Programming 
Language: $89. 
MKS Vi: the screen editor running under DOS at lightning fast speeds — it’s tuned for 
the PC. Comes with Tutorial and Reference Manual for $75. 


Mortice Kern Systems Inc., 
35 King Street North, Waterloo, Ontario, Canada, N2J 2W9 (519) 884-2251 
uucp: (allegra, decvax, ihnp4 }!watmath! mks! toolkit 
BIX userid: mks CompuServe userid: 73260,1043 
MKS software runs under MS-DOS 2.0 or later. Not copy protected. Prices quoted in US funds. VISA, 
MASTERCARD, American Express, uucp, and purchase orders (over $200) are accepted. Overseas orders 


please add $15 for postage and handling. MKS is a registered trademark of Mortice Kern Systems Inc. UNIX is 
a trademark of AT&T Bell Labs. 
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TO THE MACS 
(continued from page 101) 


and makes them active. 


doCopyrightItem—Brings up a 
modal dialog that expresses the 
author's interest in legal protection 
for works of art. 


figureCenteredRectTLC—I don't 
know about you, but I go nuts over 
programs that don’t know how to 
position things on different-size 
screens. This little routine shows 
how simple it is to be tidy. 


To be continued next month. 


Wrap Up 

Special thanks go to the following 
for thoughts and actions that made 
this month’s column possible: Tom 
Atkinson of Orchard Computer, Cyn- 
thia Bruschi of ICOM Simulations, 
Dan Cochran of Apple, Doreen 
Duplin of Think Technologies, Bruce 
Hammond of Starpoint Software, Mi- 
chael Kahl of Think Technologies, 
Jerzy Lewak of Paragon Concepts, 
John Mitchell of Apple, David 
Perlman of Action Graphics, Andrew 
Singer of Think Technologies, 
Nathan Slemmer of Interstate Com- 
puter Bank, Tyler Sperry of DDJ, 
Mike Swaine of DDJ, Levi Thomas, 
and Dan Weston of Nerdworks. 

This is the first of my DDJ Mac 
columns. Feedback pro and con will 
be much appreciated; my access in- 
formation is at the end of the 
column. Hot tips, keen insights, 
funny problems, and review copies 
of books and software are also solic- 
ited. 

Next month for sure: assembly- 
language source for rectCDEF along 
with copious explanation and the 
rest of custom control demo's re- 
SOUrCeS. 

Next month maybe (depending on 
time, space, and circumstance): hy- 
pertalk secrets, living with multiFin- 
der, macdraw with a brain, parasitic 
desk accessories, talks with various 
programming luminaries, and Micro- 
soft madness revealed. 


Stan Krute, when not serving as 
DDJ’s new Mac columnist, is an 
artist, programmer, writer, and 
teacher. You can reach him via MCI 
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68000 Programming 








Dr. Dobb’s 
Toolbook of 


by the Editors of Dr. Dobb’s 
Journal of Software Tools 


This complete collection of practical pro- 
gramming tips and techniques for the 
68000 family includes the best articles on 
68000 programming ever published in Dr. 
Dobb's Journal of Software Tools, along 
with much new material. You'll learn about 
the most important features of the 68000 
microprocessor from a full description of 
its history and design. Useful applications 
and examples will show you why comput- 
ers using the 68000 family are easy to 
design, produce, and upgrade. Contents 


SS include: 
%G 


© 68000 Instruction Set @ Bringing Up 


» the 68000: A First Step @ A 68000 Cross- 


Assembler @ A Simple Multitasking 
Kernel for Real-Time Applications @ The 
Worm Memory Test @ A Mandelbrot Pro- 
gram for the Macintosh 


All programs are also available on disk. 


Book & Disk 
(MS-DOS, CP/M 8’, Osborne, 
Macintosh, Amiga, Atari 520st) 


Item #75-5 $49.95 
Book 
item #216649-6 $29.95 




















68000 Cross Assembler 

An executable version of the 68000 Cross- 
Assembler discussed in the book is also 
available, complete with source code and 
documentation. Requires CP/M 2.2 with 64K 
or MS-DOS with 128K. 


Manual & Disk (8” SS/SD, Osborne, 
MS-DOS) 


item #71-2 $25.00 











Dr. Dobb’s 
Toolbook of 


Forth, Volume Il 
by the Editors of Dr. Dobb’s 
Journal of Software Tools 


This complete anthology of Forth program- 
ming techniques and developments picks 
up where the Toolbook of Forth, Volume I, 
left off. You'll find the best articles on Forth 
from Dr. Dobb's Journal of Software Tools, 
many of which have been updated and 
expanded. Respected experts in the Forth 
community also contribute examples of 
Forth used in many challenging and 
thought-provoking applications. Topics in- 
clude: Forth philosophy and standards; 
svstem tools such as a Forth native-code 
cross-compiler for the MC68000 and a 
simple metacompiler; math tools, includ- 
ing Forth and the Fast Fourier Transform; 
Zen Floating Point; a Forth slide rule; 
sample applications such as Forth win- 
dows for the IBM PC, with code included; 
Programming Challenges, such as a Forth- 
Oriented, Real-Time Expert System, and 
much more. The screens in the book are 
available on disk as ASCII files. 

Please specify MS-DOS, Macintosh, or CP/M 
(Osborne or 8” SS/SD). 


Book & Disk (MS-DOS, Macintosh, 
or CP/M: Osborne, 8’ SS/SD) 


item #51-8 $45.95 
Book 
item #41-0 $29.95 





Dr. Dobb’s 
Toolbook of C 


by the Editors of Dr. Dobb’s 
Journal of Software Tools 


This authoritative reference contains over 
700 pages of the best C articles and source 
code from Dr. Dobb's Journal of Software 
Tools, along with new material by C ex- 
perts. You'll find hundreds of pages of 
useful C source code, including a complete 
compiler, an assembler, and text-process- 
ing utilities. Also included: all of Anthony 
Skjellum’s C Programmer's Notebook col- 
umns distilled into one thought-provoking 
chapter. 


Book 


item 4615-3 $29.95 





Small-Tools: 
Programs for Text 


Processing 
by James E. Hendrix 


This package of programs performs spe- 
cific, modular operations on text files, in- 
cluding: editing; formatting; sorting; merg- 
ing; listing; printing; searching; changing; 
transliterating; copying; concatenating; en- 
crypting and decrypting; replacing spaces 
with tabs and tabs with spaces; counting 
characters, words, or lines; and selecting 
printer fonts. Small-Tools is supplied in 
source code form. With the Small-C Com- 
piler, you can select and adapt these tools 
to your own purposes. Documentation is 
also included. Available for MS-DOS or CP/ 
M systems. Please specify format. 


Manual & Disk (MS-DOS or CP/M) 
item #78-X $29.95 
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The Small-C 
~ Compiler and 
Small-C Handbook 


by James E.Hendrix 


This compiler and handbook provide every- 
thing you need for learning how compilers 
are constructed, and for learning C at its 
most fundamental level. You'll find a dis- 
cussion of assembly language concepts and 
program translation tools, and learn how 
to generate a new version of the compiler. 
Full source code is included. The hand- 
book and compiler on disk are available for 
both MS-DOS and CP/M systems. The hand- 
book comes with an addendum for the 
MS-DOS version. Please specify format. 


Book & Disk (MS-DOS) 


item #76-3 $42.90 
Book & Disk (CP/M) 
item #67-4 $37.90 





Small-Mac: An 
Assembler for 
Small-C 


by James E. Hendrix 


This assembler features simplicity, portabil- 
ity, adaptability, and educational value. The 
package includes: a simplified macro facil- 
ity; C language expression operators; object 
file visibility; descriptive error messages; 
and an externally defined instruction table. 
You get the macro assembler, linkage 
editor, load-and-go loader, library manager, 
CPU configuration utility, and a utility to 
dump relocatable files. Documentation is 
included. For CP/M systems only. Please 
specify format. 


Manual & Disk (CP/M) 


item #77-1 $29.95 





Small-Windows: A ., 

Library of 
Windowing 

Functions for the 
C Language 


by James E. Hendrix 





Small-Windows is a complete windowing 
library for C (Microsoft 4.0 and Small-C). 
The package includes: 18 video functions 
written in assembly language; 7 menu func- 
tions that support both static and pop-up 
menus; 41 window functions to clean, 
frame, move, hide, show, scroll, push, and 
pop windows. Two test programs are pro- 
vided as examples to show you how to use 
the library and the window, menu, and 
directory functions. 

Documentation and full C source code is 
included. 

Available for MS/PC-DOS systems for the 
following compilers: Microsoft C Version 
4.0, Small-C, Lattice C and Turbo C. 

Please specify compiler format. 


Manual & Disk (MS-DOS) 


item #35-6 $29.95 


C Disk Formats: Please specify 
MS-DOS or CP/M. For CP/M, specify: 
Apple, Kaypro, Osborne, Zenith 
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Turbo C: The Art 
of Advanced 
Program Design, 
Optimization and 
Debugging 


by Stephen R. Davis 


Overflowing with example programs, this 
book fully describes the techniques neces- 
sary to skillfully program, optimize and 
debug in Turbo C. Every topic and Turbo 
C feature discussed is fully demonstrated 
in Turbo C source code examples. Ad- 
vanced topics such as pointers; direct 
screen I/O; inline statements in Turbo C; 
and how to intercept and redirect BIOS 
calls are all covered in depth. The author 
further demonstrates these advanced topics 
by writing a RAM resident pop-up program 
in Turbo C. In addition, the author fully 
outlines the differences between Unix C 
and Turbo C; the transition from Turbo 
Pascal to Turbo C; and the superset of K&R 
C features implemented in Turbo C and 
included in the proposed ANSI C standard. 


Book & Disk (MS-DOS) 


Item #45-3 $39.95 
Book 
item #38-0 $24.95 


— 


Se CS SO Sc SS Se a. OR Le 


17 
Cc 


_ 9. 
v ~ LC 
oe: 7 
Cr ah + 

0 


Vid 


if 
t 


Ror 





C Chest and Other 
C Treasures 
from Dr. Dobb’s 


Journal 
by Allen Holub 


This comprehensive anthology contains the 
popular “C Chest” columns from Dr. Dobb's 
Journal of Software Tools, along with the 
lively philosophical and practical discus- 
sions they inspired, in addition to other 
information-packed articles by C experts. 
Topics covered include: pipes, wild-card 
expansion and quoted arguments; sorting 
routines; command-line processing; queues 
and bit maps; utilities such as ls, make, and 
more; expression parsing; hyphenation; 
IBM cursor control and an Fget that edits; 
redirection; accessing IBM video display 
memory; trees; an AVL tree database pack- 
age; directory traversal; sets; shrinking .EXE 
file images; hashing, expressions, and 
Roman numerals; and statistical applica- 
tions of digital low-pass filters. Other treas- 
ures include: a variable metric minimizer; 
Fgrep; a peephole optimizer; and curve 
fitting with cubic splines. 

All subroutines and programs are written 
in C and are available on disk with full 
source code. MS/DOS format. 


Book & Disk (MS-DOS) 
item #49-6 
Book i 
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On Command: 
Writing a Unix-Like 
Shell for MS-DOS 


by Allen Holub 


This book and ready-to-use program dem- 
onstrate how to write a Unix-like shell for 
MS-DOS, with techniques applicable to 
most other programming languages as well. 
The book and disk include a detailed de- 
scription and working version of the Shell, 
complete C source code, a thorough dis- 
cussion of low-level MS-DOS interfacing, 
and significant examples of C program- 
ming at the system level. 

Supported features include: read, aliases, 
history, redirection and pipes, Unix-like com- 
mand syntax, MS-DOS-compatible prompt 
support, C-Shell-based shell scripts, and a 
Shell variable that expands to the contents 
of a file so a program can produce text that 
is used by Shell scripts. The Unix-like con- 
trol flow includes: if/then/else; while; 
foreach; switch/case; break; continue. 

The ready-to-use program and all C source 
code are included on disk. For IBM PC and 
direct compatibles. 


Book & Disk (MS-DOS) 


Item #29-1 $39.95 
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\Util 


by Allen Holub 





When used with the Shell, this collection 
of utility programs and subroutines pro- 
vides you with a fully functional subset of 
the Unix environment. Many of the utilities 
may also be used independently. You'll 
find executable versions of cat; cp; date; 
du; echo; grep; ls; mkdir; mv; p; pause; 
printevn; rm; rmdir; sub; and chmod. 

The \Util package includes complete source 
code on disk and all programs (and most 
of the utility subroutines) are fully docu- 
mented in a Unix-style manual. For IBM 
PC and direct compatibles. 


Manual & Disk (MS-DOS) 
item #12-7 
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NR: An 
implementation 
of the Unix NROFF 


Word Processor 
by Allen Holub 


NR is a text formatter that is written in C 
and compatible with UNIX’s NROFF. Com- 
plete source code is included in the NR 
package so that it can be easily customized 
to fit your needs. NR also includes an 
implementation of the -ms (manuscript) 
macro package and an in-depth descrip- 
tion of how -ms works. NR does hyphena- 
tion and simple proportional spacing. It 
supports automatic table of contents and 
index generation, automatic footnotes and 
endnotes, italics, boldface, overstriking, un- 
derlining, and left and right margin adjust- 
ment. NR also contains: 





@ extensive macro and string capability 
@ number registers in various formats, 
including Roman and Arabic numerals, 
both spelled out and in outline form 

@ diversions and diversion traps 
(macros that are triggered automatically) 
@ input and output line traps 


NR comes configured for any 
Diablo-compatible printer, as well 

as LaserJet and Hewlett Packard's 
ThinkJet. It is easily configurable 

for most other printers. Both the 
ready-to-use program and full source 
code are included. 

For PC compatibles. 


Manual & Disk (MS-DOS) 
item #33-X $29.95 
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4 Multiple bullet proof windows 
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M Programmable keyboard handler 
@ Text editor routines 
MM No royalties or runtime fees 
@ Library source included FREE 
@ Free technical support 
MW Free BBS at (214)418-0059 
% Supports all major compilers 
including Microsoft 5.0 
 VCScreen code generator too! 
( UNIX version avaialable, 
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STRUCTURED PROGRAMMING 


Object-Oriented Programming in Pascal 


bject-oriented programming 

has become quite popular in 
the last few years. One aspect of its 
growing acceptance is the increas- 
ing number of structured and AI 
language implementations that sup- 
port this new paradigm—for exam- 
ple, there are object-oriented imple- 
mentations in C, Pascal, LISP, Logo, 
and Forth. In recognition of the maga- 
zine’s focus this month on the 68000 
line, I'll look at a new object-ori- 
ented Pascal available for the Macin- 
tosh. 

The strength and attraction of 
object-oriented programming is that 
it offers you both a new concept (or 
technique, if you like) for modular 
coding and a method for efficiently 
describing a hierarchy of data struc- 
tures (because redundant compo- 
nents need not be redeclared). 

Objects in Pascal can be regarded 
as highly evolved record structures. 
Objects declare instance variables 
(similar to fields of Pascal records) 
and instance methods, or methods 
for short. These methods are rou- 
tines that manipulate the objects. 
Consider the following object-type 
declaration: 


TYPE TRectangle = OBJECT 
{ instance variables } 
Length, 

Width : real; 

{ instance methods } 

FUNCTION Area : real; 

FUNCTION Circumf : real; 

FUNCTION Diagonal : real; 
END; 


by Namir Clement Shammas 


which declares a class of objects 
named TRectangle that contains two 
instance variables—namely, Length 
and Width. Three methods are sup- 
plied to calculate the rectangle’s 
area, circumference, and length of 
diagonal. The declared methods (all 
of which are functions in the pre- 
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Modula-2 


Fortran 


wae 





ceding example) are implicitly FOR- 
WARD declarations of the routines’ 
headings. The actual code is placed 
after all the other declarations. 

To use the TRectangle object type, 
I must declare a variable and then 
allocate its dynamic memory using 
the predefined NEW() procedure. 
Accessing the fields and routines 
employs the familiar dot notation 
used with Pascal records. Consider 
the following code fragment: 


VAR Rect : TRectangle; 
A =real; 


BEGIN 
NEW(Rect); 
Rect.Length := 8.0; 
Rect.Width := 5.0; 
A := Rect.Area; 


In this code the name of the object 
is used in conjunction with all the 
object's instance variables and meth- 
ods. 

A rectangular parallelepiped is a 
3-D rectangle that can be regarded 
as extending the 2-D “parent” shape 
into a third dimension. This means 
the parallelepiped shares the same 
features as the 2-D rectangle and 
adds a few new ones. To enable the 
parallelepiped objects to inherit the 
features of the 2-D rectangle, I de- 
clare the following: 


TYPE TSolid = OBJECT(TRectangle) 
height : real; 
FUNCTION Volume : real; 
FUNCTION Space__Diag : real; 
END; 


This declaration states that the 


object type TSolid is a child of the 
object type TRectangle. As a child 
object, it is able to inherit all the 
instance variables and methods of 
its parent object: 


VAR Solid : TSolid; 
A, V : real; 


BEGIN 
NEW(Solid); 
Solid.Length := 8.0; 
Solid. Width := 5.0; 
Solid. Height := 7.0; 
A := Solid Area; 
V := Solid.Volume; 


Notice how the variable Solid (of 
type TSolid) is able to access the 
instance variables and methods of 
the TRectangle object type directly. 
Unlike nested record structures in 
Pascal, nested objects can make 
direct reference to the ancestor's vari- 
ables and methods. 

In the preceding discussion, I 
pointed out that the class of objects 
TSolid is able to inherit components 
from its parent object. Object-ori- 
ented Pascal provides a convenient 
mechanism to enable a new sub- 
class of objects to define its own 
version of certain inherited meth- 
ods. Such methods offer either addi- 
tional or alternate ways of manipu- 
lating an object. 

Consider, for example, the case of 
making an alternate definition of the 
object type TSolid. I want to rename 
the method Space__Diag as Diago- 
nal. Because the Diagonal name is 
also used by a method in object 
TRectangle, | must resolve the con- 
flict I have just created. The key- 
word OVERRIDE is used to override 
inherited versions, so my new alter- 
nate declaration for the TSolid 
object type is: 


TYPE TSolid = OBJECT(TRectangle) 


height : real; 
FUNCTION Volume : real; 
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RIDE; 
END; 


The OVERRIDE keyword is placed 
after the sought method, followed 
by a semicolon. To revert to the 
method inherited from a parent 
object type, instead of the overrid- 
den method, the keyword INHER- 
ITED must be placed before the 
method in question. 

In certain cases it may be neces- 
sary to make a reference to an object 
associated with a method. Object 
types are similar to pointers, and 
hence they must be dynamically al- 
located. A problem arises because 
methods cannot allocate the objects 
they manipulate. To solve this di- 
lemma, object-oriented Pascal pro- 
vides a special identifier, SELF. Using 
SELF, you can make references to 
the object that is yet to be created— 
for example, the code for method 
Volume can be written as: 


FUNCTION Volume : real; 
BEGIN 
Volume := SELF.Length * 
SELF.Width * 
SELF Height; 
END; 


TML Pascal for the Mac, the only 
object-oriented Pascal implementa- 
tion I've seen, allows you to omit the 
SELF reference. 





A Sample Program 
Object-oriented programming can 
be applied across the board, includ- 
ing with basic data structures. List- 
ing One, page 66, shows a complete 
TML Pascal program that imple- 
ments simple objects to represent 
various types of simple numeric 
stacks. 

The first object defined, TStack, 
contains instance variables and meth- 
ods used by all the other object 
types. In this case, the instance vari- 
ables include the stack height and a 
Boolean flag used to indicate errors 
(in the program I use it to indicate 
that an attempt was made to pop 
an empty stack; you can also use 
the flag to indicate an attempt to 
divide by 0). The methods associ- 
ated with TStack objects initialize, 
increment, and decrement the stack 
height. 
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CONST MAX MENU = 20; 


TYPE STRING80 = STRING[80]; 
String Array = ARRAY [0..MAX+MENU] OF STRING80; 
Menu Range = 0..MAX MENU; 


TMenu = OBJECT 
{ declare instance variables } 
Menu Options : String Array; 
Num Options, 
Menu_Choice 
END; 


: Menu_Range; 


TItem Menu = OBJECT (TMenu) 

PROCEDURE Display Menu; 

FUNCTION Get Choice : Menu Range; 
END; 


TControl Item Menu = OBJECT (TMenu) ; 
Current Level : Menu Range; 
PROCEDURE Display Menu; 

FUNCTION Get Choice : Menu Range; 

END; 


TMain_ Pull Down = OBJECT (TMenu) 
PROCEDURE Display Menu; 
FUNCTION Get Choice : Menu _ Range; 
END; 


TPull Down = OBJECT (TMenu) 
Hot_Key Char : ARRAY [0.MAX MENU] OF CHAR; 
Location : ARRAY [0.MAX MENU] OF INTEGER; 
Attribute : ARRAY [0.MAX MENU] OF BYTE; 
Active : ARRAY [(0.MAX MENU] OF BOOLEAN; 
PROCEDURE Display Menu; 
FUNCTION Get_ Choice : Menu_Range; 

END; 


Lo 


_ Example 1: Declaration of object types for various kinds of menus 
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STRUCTURED PROGRAMMING 
(continued from page 109) 


The second object type, TReal- 


Stack, is a child of object TStack. It 
defines the stack as a four-element, 
real-type array. The methods associ- 
ated with this object type are Push, 
Pop, and Add. (I've omitted other 
math-related routines to keep the 
listing short.) The third type, 
THPStack, is a child of the object 
type TRealStack. This new object 
type defines the instance variable 
LastX to store the value of the first 
array element when a stack addition 
is performed. This also dictates that 
an overridden Add method be de- 
fined. 

Finally, the fourth object type, 
TIntStack, is a descendant of object 
TStack that implements an integer- 
type version of object TRealStack. 
The main code portion exercises the 
methods defined with the objects. 


Menus As Objects 

Objects find applications in other 
data structures, such as lists, arrays, 
and matrices. They can also be ap- 
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plied to data structures represent- 
ing screens, windows, and menus. 
Example 1, page 109, shows the decla- 
ration for object types representing 
different kinds of menus. 

The TMenu object type defines 


Object-oriented 
Pascal 
limits objects 
to single 
inheritance 


instance variables that perform the 
following: 


® Tackle the text for menu options. 
@®Store the number of actual op- 
tions available. 

@Store the number of the option 
selected (the Oth option is used for 
exiting from the menu). 








TIltem__Menu is a menu object 
type that builds on TMenu simply 
by adding two methods: one to dis- 
play the menu and another to 
return the selected choice. The 
object type TControl_Item—Menu 
is a modified version of 
TItem_—Menu that allows you to im- 
plement progressive menus that 
gradually reveal more options. These 
menus display an itemized menu 
that contains only the options avail- 
able to you at the current level. 

The TMain__Pull__Down_ object 
type uses the same instance vari- 
ables of object type TMenu; how- 
ever, it implements its own version 
of the methods to display the main 
menu of a pull-down menu system. 
The individual options of a pull- 
down menu are defined by the 
object type TPull_Down. This type 
declares an additional number of 
instance variables that are arrays 
that serve to: 


® Define the hot-key characters. 

®@ Locate where the hot-key charac- 
ters are displayed and their accom- 
panying display attributes. 
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STRUCTURED PROGRAMMING 
(continued from page 110) 


® Define Boolean flags to indicate 
whether an option is active or pas- 
sive. 


Inheritance Problems 
Object-oriented Pascal limits objects 
to single inheritance: one object type 
has at most one parent object type. 
Other languages and implementa- 
tions, such as Smalltalk, Object Logo, 
and ExperCommon LISP, support 
multiple inheritance. I'd like to see 
multiple inheritance implemented 
in future versions of object-oriented 
Pascal because it offers the flexibility 
and power to model real-world ob- 
jects realistically. This new level of 
sophistication generates new prob- 
lems, though. 

Among the first problems to re- 
solve is the question of inheriting 
instance variables and methods that 
are present in the ancestor objects. 
The solution involves assigning influ- 
ence levels, or priorities, to ancestor 
objects and providing the ability to 
override them. I suggest some alter- 









nate rules for resolving inheritance 
conflicts by assigning influence 
levels as follows: 


1. The first ancestor object men- 
tioned is the dominant parent, and 
all other ancestor objects are of 
equal importance. In the following 
example: 

TYPE. Car = OBJECT(Make, 

Engine, Body) 
the ancestor object Make has the 
greater influence concerning conflict- 
ing instance variables and methods 
and the objects Engine and Body 
have the same influence. This syntax 
assumes that there are no conflicts 
pending between the last two object 
types. 
2. The order of listing the ancestor 
objects indicates their influence 
levels. The following object heading 
declaration illustrates this syntax: 

TYPE Car = OBJECT(Make, 

Engine, Body) 

Here, the Make and Body object 
types have the strongest and weak- 
est influences, respectively. 
3. The list of ancestor object types is 
partitioned into two sublists using a 


C Programmers: Combine C and COMMON LISP 
to Increase the Power of Your Software 


TransLISP PLUS - 


special character—say, the bar 
symbol. The first sublist has its an- 
cestor object types listed in decreas- 
ing influence; the second has the 
rest of the ancestor object types on 
equal footing. Consider the heading: 
TYPE Car = OBJECT(Make, Engine 
| Body, Doors) 
The first sublist contains object 
types Make and Engine, and the 
second sublist contains Body and 
Doors. The object type Make has the 
dominant influence, followed by 
Engine. The Body and Doors object 
types have an equal influence, 
which is weaker than that of the 
first two. This syntax also assumes 
that there are no conflicts pending 
between the last two object types. 
4. Influence levels are explicitly as- 
signed to all ancestor object types 
using the syntax <object type> = 
<unsigned integer constant>. The 
integers used need not be in any 
particular sequence, as shown in 
the following example: 
TYPE Car = OBJECT(Make = 100, 
Engine = 1, Body = 40) 
This object type declaration indi- 
cates that the object type Make has 
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the highest influence (by virtue of 
the number assigned to it and not 
its position in the list of object 
types). By contrast, the Engine object 
type is the least influential. 


The first and third alternatives con- 
tain a common weak point: they 
may be unable to resolve all the 
inheritance conflicts. The second 
and fourth suggested syntaxes are 
conflict-proof. Nevertheless, you 
need a mechanism to arbitrate or 
override inheritance rules explicitly. 
I suggest using the keyword FROM 
to indicate the parent object type 
supplying the particular attribute, 
as shown by the following general 


syntax: 

<variable> : data <type> FROM 
<object type> 

<method> FROM <object type> 


Tracking down inherited variables 
and methods in multiple inheritance 
is much more complex than in 
single inheritance. A single link in 
the latter is replaced by a complex 
search graph in multiple inheri- 








tance. The increased real time for 
processing multiple inheritance 
could be compensated for, however, 
by using fast CPUs and electronic 
disks, which would keep the overall 
compilation time relatively short. 


A Final Note 

Writing this column for the last few 
years has been fun, but it has also 
required a great deal of writing time. 
Other obligations, including the job 
of editor of M&T’s Turbo Tech 
Report, have made it ncessary for 
me to pass this column's duties on 
to another member of the DDJ 
family. Although I will continue to 
write an occasional article for DDJ, 
this month marks my last Struc- 
tured Programming column. Thank 
you for your support, and take care 
of yourselves. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb's Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 





issue number and format (MS-DOS, 
Macintosh, Kaypro). 
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COLUMNS 


ARTIFICIAL INTELLIGENCE 


Actor Does More Than Windows 


his month I'll be looking at the 
latest version of The Whitewater 
Group's object-oriented language 
Actor. The Whitewater Group has 
been promoting this language 
simply as an effective tool for rapid 
development under Microsoft Win- 
dows. It is certainly that. But Actor 
is also the first object-oriented pro- 
gramming tool specifically designed 
for writing applications that run 
under Windows. That fact and The 
Whitewater Group’s intention to 
port Actor for other windowing sys- 
tems make it an interesting tool for 
developing precisely the AI applica- 
tions that the object-oriented ap- 
proach is good at while easing the 
burden of developing for different 
machines. In this column ['ll de- 
scribe how the latest version (1.1) of 
Actor implements some of the Mi- 
crosoft Windows constructs and will 
examine it from that perspective. 
There are so many similarities be- 
tween Smalltalk and Actor that you 
may well ask why anyone would 
develop a new language when im- 
plementations of Smalltalk already 
exist. There are two reasons. First, 
Actor was designed from the start 
to be compatible with commercial 
personal computer environments. 
Hence its built-in compatibility with 
Microsoft Windows today and The 
Whitewater Group’s plans to allow 
window environment programming 
with Actor across windowing envi- 
ronments tomorrow. Second, the 
syntax of Actor has been designed 
to be familiar to C and Pascal pro- 


by Ernest R. Tello 


grammers. The Whitewater Group's 
intent was to incorporate all that 
was good about Smalltalk in a pack- 
age tailored to the needs of present- 
day personal computer program- 
mers. 

To give you a feeling for program- 
ming in Actor, I have sprinkled some 
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sample programs. through _ this 
column as Examples 1 through 4, 
pages 116, 118, and 125. Three of 
these are familiar benchmark pro- 
grams for generating prime and 
Fibonacci numbers and the Tower 
of Hanoi and the fourth contains 
Actor author Chuck Duffs exten- 
sions for list processing. 


The Actor Desktop 

Basically, Actor runs on top of MS- 
Windows and uses the Windows fa- 
cilities to implement objects that 
allow an interactive, windowing en- 
vironment for development. As with 
MS-Windows, you can theoretically 
get along without a mouse, but you 
wouldn't want to. 

The main items used on the Actor 
desktop are the workspace windows, 
browsers, and inspectors, which are 
all modeled on the Smalltalk origi- 
nals. 

When the system first comes up, 
it shows a workspace window with 
two rows of command options along 
the top bar of the window. The com- 
mands include File, Edit, Doit!, 
Browse!, Inspect!, Show Room!, and 
Templates. 

The editing area of a workspace 
window behaves just like an inter- 
preter does. If you type in an expres- 
sion and then a carriage return, 
Actor will attempt to compile and 
execute it. If there is a body of text 
already in an editing window, then 
highlighting a portion of that code 
and clicking on Doit! will result in 
that portion of code being compiled 
and executed. The Browse! and In- 
spect! options result in a new one 
of these tools opening like a pop-up 


window on the Actor desktop. 

Inspectors are used for focusing 
on a particular object. You use them 
to examine the contents of objects 
in detail as well as to make modifica- 
tions to them. The upper-left pane 
of an inspector window contains a 
list box that displays all the instance 
variables of an object. Clicking the 
mouse on any of the items in the 
scrollable list of variables results in 
its value being displayed in the 
bottom pane of the inspector—its 
edit window. Both class objects and 
their instances can be accessed 
using inspectors. 

A browser provides a similar func- 
tion to that of an inspector, but 
instead of providing an interactive 
window on a single object, it does 
this for the entire system of classes. 
Its scrollable list box contains a list 
of all the classes currently in the 
Actor class hierarchy. The right- 
hand list box contains the methods 
for the current class. By first select- 
ing a class and then a method in 
that class, you may access the code 
in the bottom window and edit it. 
An Options selection on the browser 
menu ‘bar allows you to choose 
whether the classes are listed in 
hierarchical or alphabetical order. 


A Class Act 

Actor comes with a large class li- 
brary of ready-made code that can 
be used for building applications 
quickly, once you bridge the learn- 
ing curve of using the system and 
knowing what's there. Here is a par- 
tial list of the classes used for data 
structures and the graphics facilities 
subsumed under them: 


Object 
Collection 
Indexed Collection 
Array 
Function 
OrderedCollection 
SortedCollection 
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ARTIFICIAL INTELLIGENCE 
(continued from page 114) 





Actor Syntax 
As with languages such as C and 
Pascal, Actor encloses arguments to 


TextCollection a method in parentheses immedi- 
ByteCollection ately following the method's name 
String or selector. And like Pascal and Small- 
Symbol talk, variable assignments are made 
Struct using the colon-equal (:=) symbol. 
DosStruct Also as in Smalltalk, the way you 
GraphicsObject create new instances is by sending 
Polygon the new message to a class and as- 


Rect signing this new instance a name. 


Ellipse So, for example, you could create an 
RndRect instance of the Turtle class by 
Proc saying: 


inherit (Object, #Sieve, nil, nil,nil);!! 
now (Sieve) ;!! 


/* Returns the number of prime numbers between 0 and cnt, 
inclusive. */ 
Def sieve(self, cnt | flags, count, c) 
{ c := cnt + l; 
flags := new(Array, c); 
fill(flags, true); 
count := 1; 
do( over(2, ¢), 
{ using(i | triple) 
if flags[{i] 
then triple := i*3; 
if tripie < cnt 
then do( overBy(triple-l, c, 
it+i-1), 
{ using(j) flags[{j] := nil }); 
endif; 
count := count + 1; 
endif; 
})? 
“count; 


}i! 


Actor[#Sam] := new(Sieve) !! 
/* To run type: sieve(Sam, 100) */!! 


Example 1: Eratosthenes’ Sieve benchmark 





now(Int)!! 


/* Recursive way of finding the nth Fibonacci term. Note that 


this way of finding the Fibonacci terms is very inefficient 
because each message "spawns" two recursive messages. */ 


Def fib(self) 

{ if selt < 3 

then “1 

endif; “fib(self - 1) + fib(self - 2); 
pi! 





/* Iterative way of finding the nth Fibonacci term. */ 


Def fib2(self | term, termlBefore, term2Before) 
{ iE self < 3 
then “1 
else term := 2; termlBefore := 1; term2Before := 1; 
do(new(Interval, 3, self + 1, 1), 
{using(i) term := termlBefore + term2Before; 











term2Before := termliBefore; 
termlBefore := term; 
}): 
“term 
endif; 
di! 
Example 2: Fibonacci program & 
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Quit Wasting Time! 


As a programmer, most of your time is spent writing and de- 
bugging source code, and documenting your work. A powerful, 


easy-to-use programmable text editor could be saving you 
HOURS of unnecessary effort. 


Only MULTI-EDIT has all these time-saving features 


Fully automatic Windowing and Virtual Memory. 
Edit multiple files regardless of physical memory size. 
Easy cut-and-paste between files. 

View different parts of the same file. 


Powerful, EASY-TO-READ high-level macro language. 
Standard language syntax. 
Full access to ALL Editor functions. 
Automate repetitive tasks. 
Easy, automatic recording of keystrokes. 


Language-specific macros for ALL major languages. 
Smart indenting. 
Smart brace/parenthesis/block checking. 
Template editing. 
Supports C, Pascal, BASIC and Assembler. 


Terrific word-processing features for all your 
documentation needs. 
Intelligent word-wrap. 
Automatic pagination. 
Full print formatting with justification, bold type, 
underlining and centering. 
Even a table of contents generator. 


Compile within the editor. 
Automatically positions cursor at errors. 
Built-in MAKE capabilities. 
Run compiled program without leaving editor. 
Automatically allocates all available memory to compiler 
or program. 





Complete DOS Shell. 
Scrollable directory listing. 
Copy, Delete and Load multiple files with one command. 
Background file printing. 


Regular expression search and translate. 
Condensed Mode display, for easy viewing of your 
program structure. 


Pop-up FULL-FUNCTION Programmer’s Calculator and 
ASCII chart. 


and MOST IMPORTANT, 


the BEST user-interface on the market! 
* Extensive context-sensitive help. 

Choice of full menu system or logical function key layout. 
Function keys are always labeled on screen (no guessing 
required! ). 

¢ Excellent online, interactive tutorial. 

Keyboard may be easily reconfigured and re-labeled. 


Users of Wordstar and Turbo Pascal’s Editor could be programming in a fraction of the time with these features. 


NO EDITOR ON THE MARKET TODAY HAS ALL THESE FEATURES, OR OFFERS YOU THIS MUCH POWER 
AT A REASONABLE PRICE, EXCEPT 


a a COMPLETE 
a iti _ Fd iT S99 Or Get our FULLY FUNCTIONAL DEMO 


VERSION 2.0 





Requires IBM/PC/XT/AT/PS2 or full compatible, 256K RAM, PC/MS-DOS 
2.0 or later-Multi-Edit and American Cybernetics are trademarks of American 
Cybernetics. BRIEF is a trademark of Underware, Inc. Norton Editor is a 
trademark of Peter Norton Computing, Inc. Vedit is a registered trademark of 
CompuView Products Inc. Copyright 1987 by American Cybernetics. 


1-800-221-9280 Ext. 951 
In Arizona: 1-602-890-1166 
Credit Card and COD orders accepted 


@ Copy for only $10! 


Get our FULLY FUNCTIONAL DEMO Copy for only $10! 
To Order, Call 24 hours a day: 


American Cybernetics 


138 Madrid Plaza 
Mesa, AZ 85201 
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SQL Compatible Query System adaptable to any 
operating environment. 




























CQL Query System. A subset of the Structured 
English Query Language (SEQUEL, or SQL) 
developed by IBM. Linked files, stored views, 
and nested queries result in a complete query 
capability. File system interaction isolated in an 
interface module. Extensive documentation 
guides user development of interfaces to other 
record oriented file handlers. 


Portable Application Support System 





Portable Windowing System. Hardware 
independent windowing system with borders, 
attributes, horizontal and vertical scrolling. 
User can construct interface file for any 
hardware. Interfaces provided for PC/XT/AT 
(screen memory interface and BIOS only 
interface), MS-DOS generic (using ANSI.SYS), 
Xenix (both with and without using the curses 
interface), and C-library (no attributes). 


Screen 1/0, Report, and Form Generation 
Systems. Field level interface between 
application programs, the Query System, and 
the file system. Complete input/output 
formatting and control, automatic scrolling on 
screens and automatic pagination on forms, 
process intervention points. Seven field types: 
8-bit unsigned binary, 16 bit signed binary, 16 
bit unsigned binary, 32 bit signed binary, 
monetary (based on 32 bit binary), string, and 
date. 


Including Source Code 
$395.00 


File System interfaces include 
C-tree and BTRIEVE. 
















HARDWARE AND FILE SYSTEM 
INDEPENDENT 





MACHINE 
INDEPENDENT 
SOFTWARE 


CoRPORATION 


1415 NORTHGATE SQUARE #21D 
RESTON, VA 22090 


VISA/Master Charge accepted 


(703) 435-0413 


*C-tree is a trademark of FairCom 
IBM, SEQUEL, PC, XT, AT are trademarks of IBM Corp. 
MS-DOS and Xenix are trademarks of Microsoft Corp. 


CQL and the CQL logo are trademarks of 
Kurtzberg Computer Systems. 
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ARTIFICIAL INTELLIGENCE 
(continued from page 116) 


Barney := new(Turtle); 

In general, sending messages in 
Actor is like passing arguments but 
in reverse. The object to which the 
message is sent is treated as an 
argument. Once you have created 
the turtle Barney, you can get him 
to do your bidding by sending vari- 
ous messages that he can recognize. 
Like any authorized turtle, Barney 
knows that the message r means 
turn right, / turn left, f move for- 
ward, and b move backward. He also 
knows that down means to put his 
tail to the ground for drawing pur- 
poses and up means to pick it up 
again. 

So, if you wanted Barney to per- 
form a turtle walk in the shape of a 
square, the messages you would 
send him would be: 


down(Barney); 
f(Barney, 10); 
r(Barney, 90); 
f(Barney, 10); 
r(Barney, 90); 
f(Barney, 10); 
r(Barney, 90); 
f(Barney, 10); 
up(Barney); 


In Actor, the keyword Def is used 
to define methods. So, if you wanted 


/* ret, 


Byte August, 86 p. 146 


to teach not only Barney but also all 
authorized turtles the new message 
walkSquare, you would define the 
method: 


Def walkSquare(self, size) 

{ down(self); 
fiself,size); 
r(self, 90); 
fiself, size); 
r(self, 90); 
fiself, size); 
r(self, 90); 
fiself, size); 
up(self); 

hi 


Henceforth, to get Barney or any of 
his relatives to perform this maneu- 
ver, all you would have to do is to 


Say: 
walkSquare(Barney, 10); 


The more astute turtle watchers 
have probably noticed that this 
turtle walk is only one orientation 
for this type of maneuver. There is a 
species of turtle, admittedly rare, 
that instinctively will do its square- 
walking counterclockwise. Fortu- 
nately, object-oriented systems such 
as Actor provide a way of mirroring 
this little sidelight of natural history. 
What you can do to cover this com- 
plexity is to define a new class of 
turtle called CounterTurtle and pro- 
vide a walkSquare method for turtles 


Chad 8.13.86 “si! 


inherit (Object, #TowerOfHanoi, nil, nil, nil);!! 


now (TowerOfHanoi);!! 


Def moveTower(self, height, 
‘{ if height > 0 
then 


from, 


to, use) 


moveTower (self, height - l, from, use, to); 


moveTower(self, height - 1, use, to, from); 


endif; 


yit 


Def moveTower2 (self, height, from, to, use) 
{ dif height > 0 
then 
moveTower (self:TowerOfHanoi, height - l, 
moveTower (self:TowerOfHanoi, height - 1, use, 
endif; 


yi! 


Actor [#Hanoi] 


use, to); 
to, Erom); 


from, 


:= new(TowerOfHanoi);!! 


/* Example solves runs the Tower of Hanoi problem */!! 


moveTower (Hanoi, 3, l, 


Example 3: The Tower of Hanoi 


3, ec: 
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é : ! 

of this species that does the coun- NOW! FOR 

terclockwise variant of the standard SHIPPING OS Z 

turtle square walk. Coincidentally, Utilities for Advance users 

this also provides me with the op- OS/2 or DOS 

portunity of illustrating how new YRS! NOW, no waiting, the same program runs on 0S/2 (PROTECTED 

classes are defined in Actor. * and REAL modes) and on DOS 2.X or 3.X without modification 
The way you usually create new VEGI Help you port the DOS applications onto OS/2. Great for C, MASM, 

classes in Actor is from within a * PASCAL, DBIII+, BASIC programs and others. 

browser, so I'll do it that way first. YRS! Includes the programmer's favorite sceen editor— VI COMPATIBLE. 

Very simply, you first select the class » More than 1,000,000 UNIX programmers now use VI. 


Turtle from the class list. Then you YES! No need to do CROSS development on UNIX any more; with OS/2 
go to the Options pull-down menu - and ADOS+ you can develop and test programs on the same Machine. 
and select Make Descendant. A pop- YES! 
up window then opens that serves ° 
as a template for creating the new 
class. In this case, let’s enter Coun- 
terTurtle as the name of the class. 
Now you just click on the Accept 
button, and the system will create 
this new class and its name will be 
added to the class list and become 
part of the Actor class hierarchy. 
The other way to create new 
classes, which is what the browser 
is actually doing, is to write the 
code for it directly. The inherit state- 
ment is used for this. So, you could 
write: 


Many smart features are added, making ADOS+ becomes the most 
powerful utilities for OS/2 . Yet it’s still compatible with UNIX tools. 


@ EDITOR: ex. edit, view, ctags and vi: New ADOS+ ENHANCED FEATURES: 
features includes 25/43/50 lines, .bak, color, etc. | @ Copy files with: subdirectories, multiple 


FILE MANAGER: €P: heed, 1s, mv, pwd, rm, sum volumes, only the new files, verbose. 


. ; ; @ List the files and display the free disk 
touch, version, which and whereis. spaces in many formats. 


e TEXT HANDLER: cat. cmp, diff, grep, od, strings] @ Remove multiple files or subdirectories. 


tail, and we. @ Show subdirectory differences, support 
large text file comparison. 
e MULTI-TASK: kill, log, nice, tee and utime. @ On-line help and examples. 


® OTHERS: cal, pr and printer spooler. @ Easy to use and fast. 





MaxWare MAYimum Valves SoftWARE ONLY: $179 for OS/2 & DOS, 
- : | $99 for DOS 3.X, 2.X 
f)|1265 Payne Drive, 


Los Altos, Ca. 94022 (415) 960-1150, FAX (415) 966-1786 


, ‘ T TRADE MARKS: 0S/2, PC/DOS are trade marks of JBM, MS OS/2. MS DOS are trade marks of Microsoft, UNIX is trade mark of AT&T 
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LALR generates parsers 


for ADA, BASIC, C, Pascal, Modula 2, SQL, 
dBASE, C++, 386 Assembly, FORTRAN... 


LALR 3.0 is a complete LALR 3.0 includes: 

LALR(1) parser generator. M@ Grammars for ADA, 

It’s fast, powerful, and easy to BASIC, Turbo Pascal and 
use. So, if you’re developing Turbo C. 

a compiler, translator or Mi Parser skeleton source code 
language interface, you want with error recovery written in 
LALR. C language.* 

If you just want to learn about [Mf Lexical scanner, syntax 
language translation and checker and calculator source 
state-of-the-art parsing code in C. 


technology, t LALR. 
echnology, you wan ot $ 9 9 
MONEY-BACK 


“unbelievably fast ... can GUARANTEE 
handle very large grammars” 


COMPUTER LANGUAGE MAG., DEC. 1985 714-832-LALR 





One of the most attractive things 
about the Actor system is that it 
provides built-in classes for making 
the use of the Microsoft Windows 
user interface easier. Three main 
classes are concerned with this: 
Window, Control, and ModalDialog. 
First let's look at the Window class 
and its descendants. Here is an out- 
line of this branch of the class hier- 
archy: | 


Object 
Window 
PopupWindow 
ToolWindow 
Browser 
Inspector 
TextWindow 
EditWindow 
WorkEdit 
BrowEdit 
FileWindow 
Workspace 
ScanWindow 
WorkWindow 


Though relatively large, Window is 
just a formal or abstract class. This 
means that it implements the meth- 
ods that will be used by the sub- 


OP LALR Research « 1892 Burnt Mill * Tustin, CA 92680 


* Parser skeletons may be written in other languages. 
Requires: DOS 2.0 or later, 256K or 512K for large grammars. Overseas orders: Add £10.00. 
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ARTIFICIAL INTELLIGENCE 
(continued from page 119) 


classes that implement the special- 
ized windows that actually get in- 
stantiated and used. In particular, 
Window implements the routines 
that communicate with MS-Win- 
dows. 

The TextWindow class is one of 
the simplest descendants of Window 
that you can get to actually do real 
things. This class allows you to 
create tiled windows that can print 
text. It does this with the printString 
and printChar methods, which call 
the Textout GDI (Graphics Display 
Interface) function in MS-Windows. 

Often you will want text windows 
that can do more that just show 
text—that can allow you to go in 
and edit that text. The subclass of 
TextWindow called EditWindow pro- 
vides the code that supports this 
editing ability. The WorkEdit class 
takes this one step further by allow- 
ing you to create windows that can 
not only edit but can also enter 
Actor language statements to be 
evaluated. The three subclasses of 
WorkEdit provide the types of win- 


dows that are like those most often 
used—browsers, file browsers, and 
general-purpose workspace win- 
dows. The main difference, though, 
is that, like their ancestor TextWin- 
dow, these are tiled windows. 

The windows most often used in 
Actor come from another branch of 
the tree that is implemented with 
the class PopupWindow. The win- 
dows you get by instantiating Popup- 
Window are the familiar layered win- 
dows that stack up on top of one 
another. Unlike the tiled windows, 
however, they do not permit you to 
zoom or contract them down to an 
icon. As is dictated by MS-Windows, 
pop-up windows have to have a 
“parent” text window. When. this 
parent window is contracted into 
an icon, then the pop-up windows 
associated with it temporarily 
become invisible. 


Controls and Dialog Boxes 

As in MS-Windows, in Actor a con- 
trol is a special type of window that 
is used for routine input and output 
in a user interface. Examples of con- 
trols include things like buttons, list 
boxes, and scroll bars. The branch 


The 
Heap Expander” 
version 2.0 


Now your programs can have virtually unlimited heap space using expanded 
memory, extended memory, disk space, or any combination of the three. And it’s all 
transparent. The Heap Expander’s startup code checks the system’s resources and 


uses whatever is available. 


@ Uses LIM-standard expanded memory 
if present. 


e@ Uses AT-style extended memory if 
present. 
@ Swaps data to disk as needed. 


MC/VISA/COD call 
1-800-248-1045 x 100(US) 
1-800-952-5560 x 100 (Idaho) 


*Idaho residents add 5% sales tax 
Foreign customers add $4.00 for shipping 
and handling. ; 





Libraries and Source Code for: 
Turbo C 
Microsoft C 4.0 and 5.0 
Mark WilliamsC 3.1 and 4.0 
Lattice C 3.2 
Turbo Pascal 3.0 and 4.0 
Logitech Modula-2/86 


Requires an!IBM PC, XT, AT, orclose 
compatible with MS-DOS or PC-DOS version 
2.0 or above 


The Tool Makers 


P.O. Box 8976 
Moscow, Idaho 83843 
208-883-4979 
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of the class tree concerned with con- 
trols looks like this: 


Object 
Control 
Button 
ListBox 
ClassList 
Scrollbar 


Like Window, the Control class in 
Actor is just a formal one, and its 
subclasses are the ones that are ac- 
tually instantiated in applications. 
Controls are handled in Actor in an 
almost identical way to windows. 
New instances are created by send- 
ing the new message, and they are 
displayed by sending the show mes- 
sage. 

I'll describe one other class—the 
ModalDialog class and its subclasses. 


Object 
ModalDialog 
ClassDialog 
DebugDialog 
DirtyCLD 
FileDialog 
InputDialog 


Modal dialog boxes resemble pop- 
up windows in that they stack on 
top of other windows and they need 
a parent window with which they 
are associated. Like Window and Con- 
trol, ModalDialog is basically an ab- 
stract class that implements code 
intended for use by its descendants. 
The FileDialog class in Actor is used 
to create the dialog boxes that rou- 
tinely appear in MS-Windows when 
you load a file by using a pull-down 
menu. The ClassDialog class is for 
dialog objects used when a class is 
being edited or created with a 
browser. 


Using Actor for AI 
For AI applications, as well as many 
other types of application, process- 
ing linked lists is essential. How do 
you go about doing that in Actor? 
One way might be to work with the 
OrderedCollection class and add sub- 
classes to it with the necessary meth- 
ods defined for list processing. 
Example 4, a demo provided with 
the current release of Actor, offers 
another approach, however. The 
new class ListNode is defined as a 
subclass of the Collection class. The 
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Use this card for FREE, FAST information about the 
products and services listed in this issue. Simply circle the 
appropriate numbers below. 
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Company ___ 
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Smart buyers start with DDUs free 
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services advertised in this very issue: everything from software 
and systems to peripherals and professional support services. 

And smart buyers can use this free information card to 
quickly and easily gather a comprehensive file of facts, figures | 
and product specs to sort out competing claims. Using DDU's 
free information card can prevent you from making the wrong, 
costly buying decision. 
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ARTIFICIAL INTELLIGENCE 
(continued from page 120) 


methods append, do, isAtom, print- 
On, and rPrintOn are defined for 
this new class. New methods, in- 
cluding isAtom, rPrintOn, and cons, 
are also defined for the root class, 
Object. If you inspect the code for 
cons, you will see that there is a 
routine for sending the message new 
to the ListNode class and creating a 
new instance of it. Obviously, this is 
only the rudimentary beginning of 
what a functional list-processing 
class would encompass. 

As far as the suitability of Actor for 
AI applications is concerned, the 
same limitations that apply to Small- 
talk apply here. As compared with 
LISP and PROLOG, Smalltalk and 
Actor are relatively low-level lan- 
guages. They are suitable for devel- 
oping AI applications, but many ad- 
ditional high-level methods and 
classes have to be written from 
scratch just to get started. 

The structures used by the Or- 
deredCollection class differ signifi- 
cantly from dynamically modifiable 
linked lists. In the terminology of 
object-oriented programming, or- 
dered collections are fixed collec- 
tions that are nevertheless “grow- 
able.” This means that when you 
create an OrderedCollection, you 
must create one with a maximum 
number of elements. If the elements 
already stored in the collection have 
not yet reached the maximum, it is 
easy to add new elements to the 
beginning or end of the list. When 
the maximum is reached, and you 
need more, you must send the grow 
message to the collection. What 
really happens when you do this is 
that a new array of the needed size 
is created and the elements of the 
old array are copied into it. 


Debugging 
With Version 1.1 a new debugger 
has been added to Actor. Currently, 
both a low-level and high-level de- 
bugger are provided, but the low- 
level debugger is not formally sup- 
ported and may disappear in later 
releases of the Actor system. 
Routine errors in code evaluated 
by Actor result in a dialog box that 
contains a stack history up to the 
point of the error. The dialog box 





usually also contains a message that 
diagnoses the type of error. If you 
wish, when a dialog box is open 
because of an error, you can click 
on the Debug button and cause a 
Debug window to open. 

This is a versatile debugging tool 
that combines some of the features 
of a browser and some of those of 
an inspector as well as the ability to 
change any of the values associated 
with a method. With it you can also 
resume processing on the fly imme- 
diately after an error has been fixed. 


Conclusions 

On the whole, I find Actor to be a 
thorough implementation of a full 
programming system with an excel- 
lent set of demo programs and help- 
fully written documentation and tu- 
torials. The ideal users of Actor, as I 
see it, would be programmers who 
have already had some exposure to 
Smalltalk and need to prototype 
something quickly to run in the MS- 
Windows environment. For pur- 
poses such as these, it is hard to 
beat. 

One thing about the implementa- 
tion of Actor I dislike, though, is the 
absence of a facility for multiple in- 
heritance. With systems intended for 
real-world applications, multiple in- 
heritance should be a standard fea- 
ture because in the real world many 
things fulfill multiple roles and mul- 
tiple functions. Multiple inheritance 
provides a ready way of handling 
this in an explicit way. 

Vendors of object-oriented tools 
who fail to include multiple inheri- 
tance typically say that they do not 
want to make the system too com- 
plex for users or that none of their 
customers have requested it. I have 
not found either of these explana- 
tions at all convincing. I have had 
no difficulty in using multiple in- 
heritance in systems that have it 
and can’t imagine trying to build a 
serious object-oriented application 
without it. 

In response to this, it might be 
said that you can still create classes 
of the same definition in a system 
without multiple inheritance the 
hard way simply by defining them 
to be exactly what you want. My 
feeling about this is that it may be 
true in theory but it tends to be 
something that is never done in prac- 
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C:>DEBUG PROGRAN.CON 
-bD100 136 


8848:0130 CD 21 CD 20 S8& EB 2F 
-Q@ 


8848:0100 EB 18 49 GE 63 6F 72 72-65 63 74 20 44 4F 53 20 k.Incorrect DOS 
86848:0110 76 65 72 73 69 GF 6E OD-OA 24 50 B4 30 CD 21 86 version..®P40N!. 
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HOO100: JMP Short HOO11A 300100 EBi8 ab 
ap earn oh aay A Saha a i eae as aorta ecto So we he eee dw See arene eben @ eneres'ad lake 
O DB “Incorrect DOS version" 300102 496E636F727265 O 
DB ODh 300117 
DB OAh 300118 
O DB “s" 300119 24 O 
HOO11A: PUSH AX 30011A SO P 
O NOV AH, 30h 30011B B430 _O O 
INT 2ih 31-DOS_Ver_Number 30011D CD21 =? 
XCHG AH, AL 3;0011F 86E0 Sas 
CNP AX,0136h 300121 3D3601 =6_ 
O JB HOO12B : o « wile + #300124 7205 r_ O 
CMP AX,O20Ah 300126 3DOA02 "Vie 
JBE HOO134 : 300123 7609 v_ 
O HOO12B: MOV DX ,0102h 3;0012B BAO201 a O 
MOV AH,O9h 3;0012E B409 on 
INT 2ih 31-Display_String 300130 CD21 ae 
INT 20h s;TERM_norrmeally:20h ;00132 CD20 JS 
(J [  geressstien eee sais pant tren ares seer tneredsae es O 
HOO134: POP AX 300134 58 xX 
JMP Short HOO166 300135 EB2F 4 
O , O 
MASTER*KEY XREF - PROGRAN.XRF Page i 
O O 
0102h : i2i 2F5 301 320 
O20Ah : 126 
O3CBh : i2B 
O i-Display_String $ 130 591 619 
1-DOS_Ver_Nuaber : 11D 
HOO100 $ 100 
O HOO11A : 100 11A 
HOO12B 3 124 12B 
HOO134 : 129 134 
HOO166 $ 135 
O TERM_normally:20h : 132 
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any program. 
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Pascal programs. 
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2320 E Street, Dept. 44, La Verne, CA 91750 714-596-0070 


. Make software more compatible with your 


computer. Be certain a questionable program 
won't damage your system BEFORE you runit. 


. Modify software to operate with other 


versions of DOS. 
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executable program directly or by reassem- 
bling your altered MASTER*KEY source code. 


MASTER * KEY shouid not be confused with any public 
domain or share ware software that may have a 
similar name or be a similar product. 
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Now you can play Assembler 
in the key of C. risC" from IMSI: 





Sometimes you've just got to write in Assembler. It's 
tedious. But it makes the machine perform. 

When you're used to writing in a friendlier and easier 
language like C, working in Assembler is a little like 

1g working in Greek. But now, there is a better way to 
ATTA, write Assembler code. Add unbelievable speed to 
Ss’ program development. And make programs easier to 
maintain. It’s called risC. 

risC transposes for you. Fast. risC is the first portable, C-like, object- 
oriented, High-level Assembly Language (HAL). It includes features of 
object-oriented high-level languages like Smalltalk, Objective C, LISP and 
PROLOG. 

You write in a C-like syntax, and risC transposes to Assembler. At 
Assembler speeds. With tight Assembler precision. 

Your objects will work in concert. With risC, your program costs will 
go down, because you can create objects and operators to go with them. 
And risC contains a complete object-oriented messaging kernel (source 
code included) which allows risC objects (.EXE files) to pass messages back 
and forth. 

Add your own personal touch. You can tailor the language to your 
own personal style. risC’s flexible syntax allows you to 
create customized compilers thanks to its lan- 
guage extension capabilities (“packages’). risC 
keeps “packages” in compiled form for speedy 
compilation times. Your development process 
will go faster than ever before. 

Your program development costs will be reduced 
even more because risC allows you to specify 
the exact Assembler code generated by each object/ 
operator combination. Producing .ASM files with risC 
variable names and comments intact. 

risC helps you identify when you're off key. 
You'll have better applications. Faster and cheaper. 
Because risC allows debugging two ways: under its own 
source code debugger, DBG, and under Microsoft's 
CodeView. To bring down your development time and 
costs even more, risC interfaces with a large variety of 
existing .OB] library routines. 
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you're a serious programmer, you'll find risC is a serious programming tool. 


It's just easier. 
Microsoft and CodeView are registered trademarks of Microsoft Corporation. 


Order today. And play Assembler in the key of risC. 
Only $79.95, with a 30-day, money-back guarantee. In CA add 6% sales tax. 


To order risC, just call IMSI at (415) 454-7101, or call toll-free, 1-800-222-4723. (In CA call 
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IMSI, 1299 4th Street, San Rafael, CA 94901. Please add $3.00 shipping and handling. 
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tice. In the two years or so that I 
have worked with object-oriented 
programming systems, I have never 
done this unless the system pro- 
vided for multiple inheritance, in 
which case it becomes a routine 
practice. 

The reason is the same one that 
makes interactive systems such as 
Actor significant and not just a mere 
convenience. The more you make 
basic things easy to do, the more 
you tend to launch out into the 
more difficult areas creatively, trying 
things that otherwise you might not 
have tried. If you are a user of an 
object-oriented programming tool 
that lacks this feature, I strongly rec- 
ommend that you pester the vendor 
to put it at the top of the list for new 
features. I feel almost certain that 
you will not regret the results of 
having exercised your prerogative as 
a customer. 

Version 1.1 of Actor differs from 
1.0 in two main ways. First of all, 
there is more space—an additional 
70K—for compiling applications. 
Second, it is fully compatible with 
Windows II, though it does not fully 
support all of Windows II's facilities. 
A future release of Actor, though, 
will actually support programming 
with the new features of Windows 
II. Needless to say, the implementa- 
tions of Actor that will use the full 
features of Windows II and the OS/2 
Presentation Manager will ultimately 
determine the fate of this product. 
But if the current implementation is 
any indication, the future versions 
should be of very high quality 
indeed. 


DDJ 
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C.B.Duff 7.13.86 
(c) Copyright, 1986 
The Whitewater Group 
Technology Innovation Center 

906 University Place 

Evanston, I1. 60201 (312) 491-2370 * / 


now(NilClass);!! 

/* append nil to a node */ 
Def append(self, aNode) 

{ *aNode }!! 








Def cons(self, aNode) 
{ *aNode }!! 


Def rPrintOn(self, aStrm) 
{ printOn('[', aStrm); 
pi: 


inherit (Collection, #ListNode, #(left right), nil,nil);!! 
now(ListNode) ;!! 


Def append(self, aNode) 
{ “cons( left, append(right, aNode)); 
bit 


Def do(self, aBlock) 

{ if isAtom(left) 

then eval(aBlock, left); 
else do(left, aBlock); 
endif; 

Gf right 

then do(right, aBlock); 
endif; 


ne 


Def isAtom(self) 
{ “mil jt 


Def printOn(self, aStrm) 
{ printOn('{', aStrm); 
printOn(left, aStrm); 
rPrintOn(right, aStrm); 
pi! 


Def rPrintOn(self, aStrm) 
{ PprintOn(* ‘, aStrm); printOn(left, aStrm);> 
rPrintOn(right, aStrm); 
PrintOn('|', asStrm)> 
pt! 


now (Object) ;!! 


Def isAtom(self) 
{ Fil 


Def rPrintOn(self, aStrm) 
{ printOn(’.*, aStrm); 
erintOn(® §, aStrm)> 
printOn(self, aStrm); 
printOn(’|', asStrm); 

pi! 


Def cons(self, aNode | newNode) 
{ if isAtom(aNode) 
then newNode := new(ListNode) ; 
else newNode := copy(aNode); 
endif; 
newNode.left := self; 
newNode.right := aNode; 
“newNode; 





} i: 








Example 4: List-handling support in Actor 
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dBASE Programmers 


You need it! 
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| | [® You can handle it! 
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\ 3dB2c is here now! 


dB2c Offers: 

¢ Version 2.0 complete with 
Translator and File 
Handlers. 

¢ Extensive implementation 
of dBASE Ill+ with over 200 
functions and commands in 
C source code. 

¢ Contains our own File 
Handlers plus interfaces for 
Lattice's dBC and Faircom's 
c-tree. 

¢ Supports screen I/O with 
ANSI.SYS or fast assembler 
routines. 

¢ Support for Microsoft, 
Lattice and Turbo C 
compilers. 

¢ Tutor features of transi!ation 
combined with familiar 
syntax of the library eases 
the transition to 'C’. 

¢ One version supports MS- 
DOS, Xenix, Unix, OS-9 
and Concurrent DOS. 


are you 
ready? 
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Toolkit $299 
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SOFTWARE 
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LETTERS 


(continued from page 12) 


is a defining word UNITS: 


: UNITS CREATE SWAP , , DOES> 
D@ */; 


Then you would have what appears 
in Example 1, page 12. This is an 
improvement, but Forth permits a 
simple addition that allows conver- 
sion back to the input units when 
outputting (see Example 2, page 12). 

Obvious modifications include use 
of floating point (to prevent the un- 
intentional truncations of integer 
arithmetic) and defining a machine- 
code sequence <DO-UNITS> to re- 
place the run-time instructions fol- 
lowing DOES> if greater speed is 
needed. (It probably isn’t—these defi- 
nitions are intended to I/O a rela- 
tively small set of measurements 
from the console or a file.) 

Finally, let me put in a plug for 
HS/FORTH (for IBM PCs/clones): Jim 
Callahan’s Harvard Softworks (P.O. 
Box 69, Springfield, OH 45066) has 
been extremely supportive with up- 
grades, fixes, technical advice, and 
so on. The version of Forth is ex- 





tremely fast “as is” but comes with 
all sorts of goodies and tools for 
using the 8087 chip, string handling, 
windowing, graphics, sound, and so 
on. Although the documentation of 
several years ago was rather cryptic, 
it is now excellent and includes 
Kelly and Spies’ textbook. I have 
never seen this product reviewed or 
mentioned and cannot imagine why, 
considering its excellence. 

Julian V. Noble 

105 Powhatan Cir. 

Charlottesville, VA 22901 


Instruction Timings 

Dear DDJ, 

I hate to be the bearer of bad news, 
but Tom Disque’s “8088 Assembly- 
Language Programming Techniques’ 
in the July 1987 issue is inaccurate. 
In several cases Disque presents in- 
struction timings that are not con- 
sistent with his assumptions. 

In the second paragraph, Disque 
says, ‘Please note that all timings 
are for the 8088 microprocessor and 
assume that the 4-byte 8088 pre- 
fetch queue is empty at the start of 
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C TOOLSET © 


Unix-like Utilities for 
Managing C Source Code 


No C programmer should be with- 
out an assistant. C ToolSet provides 
you with the support you need to 
make C programming easier. 

All of the utilities are tailored to 
the C language but you can modify 
them to work with other languages 
as well. 

Source code in standard K&R C 
is included. You are welcome to use 
it with any compiler (UNIX com- 
patible) and operating system you 
choose. 

The documentation contains de- 
scriptions of each program, a listing 
of program options, and a sample 
run. On-line help responds to -? on 
the command line with a list of 
options 


(>) Coder’s 
—Yj4 Source™ 


12 Time Savers 


DIFF - Compare files line by line; 
use CMP to compare byte by byte. 
GREP - Regular expression search. 
FCHART - Trace the flow of control 
between large program modules. 
PP - Format C program files so they 
are easier to read. 

CUTIL - General purpose file filter. 
CCREF - Cross reference variables. 
CBC (curly brace checker) - Check 
for pairing of curly braces, parens, 
quotes, and comments. 

Other utilities include DOCMAKE, 
ASCII, NOCOM, AND PRINT. 


Requires MSDOS and 12K RAM 


MONEYBACK GUARANTEE 


Try C ToolSet ($95) for 30 days — 
if not satisfied get a full refund. 


Call (800) 255-4659 


In MA (617) 331-0800 


541-D Main St., Suite 412, So. Weymouth, MA 02190 
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execution.” Although this is a good 
assumption because the 8088 is so 
common and the prefetch queue is 
always empty except for a few rela- 
tively rare circumstances, the tim- 
ings that Disque gives for his in- 
struction sequences do not corre- 
spond to this statement. 

Disque claims that the simple se- 
quence: 


MOV ax, CS 
MOV €S, ax 


takes four cycles to execute. If the 
prefetch queue is empty, however, 
the instructions must be fetched 
first. These two instructions are 4 
bytes, and the 8088 requires four 
clock cycles per memory cycle. This 
alone comes to 4X4, or 16 clock 
cycles, just to fetch the instructions, 
never mind any additional execu- 
tion time. If the prefetch queue were 
full, you would have a different 
story, but Disque assumed that it 
wasn t. 

I suspect that Disque probably 
meant to do better than this be- 
cause later he gives the example: 


shl ax, 1 
shl ax, 1 
shl ax, 1 
shl ax, 1 


He says: ‘Faster (8 cycles [plus 8 
more to fetch the two extra instruc- 
tions] .’ I'm not sure what to 
make of this. Either he meant to 
assume the prefetch queue was 
empty or that it was full. In any 
case, it would take 16 clock cycles 
to fetch two instructions, not 8 (4 
clock cycles per byte times 2 bytes 
per instruction times 2 instructions). 

Let’s examine how the 8088 really 
executes the previous sequence. 
First, it must fetch the first instruc- 
tion—eight clocks. It then starts fetch- 
ing the second instruction while 
processing the first one. Processing 
the instruction takes two clocks and 
fetching the second _ instruction 


takes eight. Because eight is more 
than two, you really have to wait 
eight clock cycles. At this point the 
cycle repeats. The total “execution” 
time is 32 clock cycles. 

As you can see, it takes the 8088 
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You’ve got better things to do than repeat the same steps. Greenleaf DataWindows 
Over. . . and over. . . and over. Up your productivity with and Turbo C 
Greenleaf Software. 7 a DataWindows, the finest C 

With more than 70 new functions added to our popular libraries, programming windows tool 
Greenleaf is now the most complete and mature C language function available, puts windows, transaction 
resource available. It’s no wonder we’ve been rated the best. Winning data entry and menus at your 
program developers in major corporations such as IBM, EDS and GM fingertips. 
have proven our reliability in thousands of applications. Our new TURBO C versions 


Step Livel are ready to get you going fast! 
New iprecriieat Functions v.3.10 includes 295 of the functions you’ve And our new 3-in-1 C Sampler 
been asking for — DOS, disk, video, color text and graphics, string, for only $94.50 supports Turbo C 
time/date, keyboard, plus many more! With Greenleaf, or Quick C with comm, windows, 
you'll finish faster. menus and more! Our libraries 

Cut Corners support all popular C compilers 


When it comes to merging information, the new Greenleaf Comm for MS DOS. 
Library v.2.10 is the fastest communications facility of 
its kind. Over 120 functions — ring buffered, 
interrupt-driven asynchronous communications. And, 
only Greenleaf gives you the power to build a 16-port 
communication system. 


Get on the Fast Track 


Order your new Greenleaf library today! See your In Texas and Alaska: 


Spectators sissoo GREENILEAF 9)4-949-956) 





















Call Toll Free: 


OOU-323-9830 








Greenleaf Functions $185.00 
Greenleaf DataWindows $225.00 
Greenleaf C Sampler $ 94.50 
Digiboard Comm4 $325.00 Greenleaf Software, Inc. 
Digiboard Comms $535.00 16479 Dallas Parkway, Suite 570 


In stock, shipped next day. Dallas, Texas 75248 
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much longer to fetch its instruc- 
tions than to execute them, so the 
8088's speed is proportional to the 
number of bytes it must transfer. 
This includes instruction bytes as 
well as data processed by a _ pro- 
gram. This also means that the 
8088's 4-byte queue is almost always 
| empty. 

The few exceptions are multiply 
and divide instructions, which take 
longer to execute than to fetch. 
There are also a few esoteric instruc- 
tions that take longer to execute 
than to fetch, but their use is so rare 
that you can forget about them. 

Therefore, to time 8088 code that 
does not include multiply or divide 
instructions, all you have to do is 
add the number of bytes of instruc- 
tion that must be fetched to the 
number of bytes of data transferred 
in memory. Once you have the total 
number of reads and writes to 
memory, you multiply by four clocks 
per fetch. You need no instruction 
timing tables or photographic 
memory. All you need to be able to 





do is count and multiply by 4 (two 
left shifts in binary). 

This same concept is used to time 
Z80 code, except for one quirk. The 
Z80 takes four clocks for the first 
byte of an instruction fetch and 
three clocks to fetch the data. 

What about the 8086? The 8086 
can fetch instructions faster than 
the 8088 can but is still basically 
limited to how fast it can fetch in- 
structions (and read/write to 
memory). The 80386 should finally 
provide enough memory width (32 
bits) to make a prefetch queue worth- 
while. 

Disque redeems himself, however, 
with his Example 8, which demon- 
strates an excellent, fast, general- 
purpose, memory move routine. The 
correction for odd address transfers 
shows good understanding of that 
aspect of the 8086 processor. 

Good assembly-language program- 
mers such as Disque are rare, but 
sometimes we all become victims of 
Intel’s overly optimistic instruction 
timings. Disque’s instruction timings 














PROGRAMMERS! 


THE TooLs YoU NEED 
AT A PRICE YOU’LL LIKE 


Supports all index file operations. Very quick 
sequential or random access, duplicate keys, multiple 
indices, fixed and variable length data records are all supported. 


Works on top of BTree to provide a simple, yet 
powerful application program/file system interface. 


75.00 ¢ NOW 


MULTI 
-USER 
AVAILABLE 


40.00 


Complex filesystem manipulation becomes a snap. Provides the power 


of a database manager with the flexibility of a programming language. 


60.00 


Finally, a completely device independent printer library! 


lp drives any printer as accurately as possible and allows easy access to 


75.00 


its most sophisticated features. Multiple fonts, multi-column output, complex margin 
formatting, and much more. Pays for itself the first time it’s used. 


The ultimate ‘make’ utility. We couldn’t find a good one, so 


we wrote a great one. Has all kinds of powerful features including wild 


59.00 


card filename expansion, nested macros, and multiple dependency and rules defini- 
tions. Ready to go for MS-DOS; C source is there if you use another operating 


system. 





sound like they came from Intel. 
Lee Pelletier 
5 Burley St. 
Wenham, MA 01984 


Correction 
Dear DDJ, 
I'd like to provide some additional 
information about the Async Ap- 
pleTalk article published in the Oc- 
tober 1987 issue of DDJ. 

Async AppleTalk is based on the 


source code of Apple Computer's 


AppleTalk driver. The following 
notice was dropped from the article 
during the editing process: The Ap- 
pleTalk protocols and computer pro- 
grams are licensed from Apple Com- 
puter Inc. and AppleTalk, Macin- 
tosh, and LaserWriter are trademarks 
of Apple Computer Inc. Portions 
copyright (c) 1985 Apple Computer 
and copyright (c) 1987 the Trustees 
of Dartmouth College. 
Also, the disk being distributed by 
DDJ does not contain the executable 
desk accessory. This, along with the 
source files and other debugging 














Combine & Save: BTree + ISAM + Ip 159.00+ snake 199.00 


Each product includes a typeset manual, example programs, and complete C source 
code that runs on any operating system. Softfocus products may be incorporated into 
applications royalty-free. 


Credit card orders accepted. Visa, M/C, Amex. Dealer inquiries invited. 


1343 Stanbury Drive 
Oakville, Ontario, Canada 
L6L 2J5 

(416) 825-0903 
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tools, is available from the authors. 
Please send a blank (800K) Macin- 
tosh disk in a mailer to me at the 
address listed below. 

Richard Brown 

Dartmouth College 

Async AppleTalk Distribution 

Kiewit Computer Center 

Hanover, NH 03755 





Stonecutter Error 

Dear DDJ, 

With reference to the cover of your 
September 1987 issue, the statement 


TAKAGUCK will never be executed | 


because ZOK-OOT-UK always sets 
GLOOTBLEE false. The correct state- 
ment should be XOK-OOT-OK, 


before printing. 
James Sturdevant 
Minneapolis, MN 


To List or Not to List 
Dear DDJ, 
In response to your question about 





EE 








source listings in Running Light (No- 
vember 1987), I personally feel a big 
value in DDJ is the source listings. I 
use them and I'm sure a lot of the 
silent majority do too. You're right 
about a typing drill, so I normally 
try to download instead to typing. I 
agree with posting them on Com- 
puServe, and maybe the idea of a 
BBS run by DDJ would be a good 
addition. Most of the bigger PC pub- 
lications have established one for 
their readers. 

One different idea I would like to 
push is the use of Cauzin Softstrips 
from Cauzin Systems ([203] 573-0150) 
in each publication, like PC Maga- 


_ zine does. Cauzin readers are cheap 
which uses GLOOTBLEE as an error | 
indicator. Please inform your stone- | 
cutter to proofread the algorithms | 


($200) and will pay for themselves to 
readers like me who are far removed 
from California. I thought you were 
using Softstrips at one time, and I'm 
not sure what happened. Anyway, it 
is a cheap alternative for avid soft- 
ware users like me. 

I hope you will consider my sug- 
gestion. It would sure be a help to a 
lot of us. 
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What is C_ talk'™ 





The Power of OOLs 


of _OOLs. C_talk™ contains: 


* Encapsulation (“objects”) * Messaging 



















The Efficiency of C 


* Speed, Size, Flexibility + Ease of Application Delivery 


new operation - the message. 


The Productivity of C_talk™ 


+ Define software components in object-oriented terms. 

* Extend software components with full class-inheritance. 

* Automatically convert work into C code. 

* Reuse software components to obtain results in less time. 
+ Learn quickly using standard C in C_talk™. 


ES Cuma cae Cty 


and mouse is highly recommended. 


CNS, Inc. a 
Software Products Dept. a2 
7090 Shady Oak Road 
Eden Prairie, MN 55344 tat <— 
(612) 944-0170 we at = 








PRICE: $149.95 : sac 
Credit Gas finer Card, Visa a 
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C_talk is a trade mark of CNS, Inc. 


OBJECT-ORIENTED PROGRAMMING IN C 


C_talk™ is an object-oriented development environment in C with Smalltalk4ike messaging formats. 
software developer use the C_talk™ Browser to develop an object-oriented program, then use the C_talk™ Compiler 
to convert this program into C code compatible with most popular C compilers. The combined data abstraction power 
of object-oriented programming with the efficiency, speed, and flexibility of C results in a high productivity 
development and delivery environment which can significantly cut development time. C_talk™ offers: 


C_talk™ is designed to let you take full advantage of object-oriented languages (_OOLs). It is designed so that both 
the object-oriented guru and the "non-objecting" neophyte can use C_talk™ to explore and exploit the exciting world 


* Inheritance 


C_talk™ does just what its name suggests — lets you talk in C, and thereby gives you all the efficiency and advantages 
of C: 


* Access to C libraries and C tool sets 


The user of standard C will find programming in C_talk™ is basically programming in C, but with a powerful 
difference: C_talk™ is an object-oriented environment. C_talk introduces to C a new data type - the object, and a 


C_talk™ is a synergy of C and Smalitalk-like features — yielding much greater productivity to the software builder: 


C_talk™ (version 1.0) is designed to run on the IBM® PC (or compatibles) with graphics (CGA, EGA, PGA) and with 
one of the following C languages: Microsoft® C, Lattice C, Turbo C, or C86. A system configured with a hard drive 
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It lets the 















David Doss 

Computer Science Dept. 
Illinois State University 
133 B Stevenson Hall 
Normal, IL 61761 


Dear DDJ, 
I have a few comments regarding 
your question about the source list- 
ings. Keep small (one or two pages) 
listings. Put long listings on a BBS 
and make them available on disk. 
CompuServe is no solution. PC Maga- 
zine, Byte, and Computer Language 
all have great BBSs for downloading. 
Also, make sure all necessary in- 
clude files are present for C pro- 
grams. Most published C source 
code is useless because the author 
uses routines hidden in header files 
that are not provided. 

Edgar T. Lynk 2G 

70 Park Terrace East 

New York, NY 10034 
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TURBO C QUICK C LET'S C DESMET C DATALIGHT C ECO-C 
LATTICE C MICROSOFT C AZTEC C COMPUTER INNOVATIONS C 


NEW --- Limited time offer. 


Peacock System's CBTREE 


Object library for only $49! 


Our FULL COMMERCIAL VERSION of CBTREE in object library format 
is being offered for the amazingly low price of $49. 


CBTREE provides you with easy to use functions that maintain key 
indexes on your data records. These indexes provide you with fast, 


keyed access, using the industry standard B+tree access method. 


Everything you need to fully utilize CBTREE in your applications is 
included. The CBTREE source code can be purchased later at any 


time for the $50 difference. Example source programs and utilities are 


included FREE. 


CBTREE source library $99 
Object library only 


$49 


This limited time offer is simply too good to refuse. Peacock's standard 
ROYALTY FREE, UNCONDITIONAL MONEY-BACK GUARANTEE, 


Aoventure 
in Programming! 
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AND FREE TECHNICAL SUPPORT applies to this offer. 


To order or for additional information 
Call (703) 356-7029 or (703) 847-1743 or write: 


PEACOCK SYSTEMS, INC. 
2108 GALLOWS ROAD, SUITE C 
VIENNA, VA 22180 


PEACOCK SYSTEMS, INC. 
Trademarks: Turbo C (Borland); Quick C (Microsoft); Let's C (Mark Williams); DeSmet C (DeSmet 
Software); Datalight (Datalight); Lattice C (Lattice); Microsoft C (Microsoft); Aztec C (Manx Software); 
Computer Innovations C (Computer Innovations); Eco-C (Ecosoft, Inc). 
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PROGRAMMER’S SERVICES 


OF INTEREST 








Language Products 

for the Mac 

Two new versions of LPA 
MacPROLOG are available from 
Logic Programming Associates: 
the Student Edition uses a built-in 
incremental compiler and a high- 


powered declarative graphics envi-' 


ronment; the Wizard Edition also 
has a built-in incremental compiler 
| and high-powered declarative graph- 
ics environment along with a new C 
and Pascal interface, serial I/O, and 
an optimizing compiler. Both ver- 
sions require 1 megabyte of memory. 
The Student Edition costs $275, and 
the Wizard Edition costs $495. 
Reader Service No. 16. 

Logic Programming Associates 
Studio 4 

The Royal Victoria Patriotic Building 
Trinity Rd. 

London SW18 35X 

England 

01-8711-2016 


Version 2.0 of True BASIC, a lan- 
guage system for the Macintosh and 
the Macintosh II developed by True 
BASIC Inc., is now shipping. True 
BASIC 2.0 offers several new features, 
including enhancements to the 
editor; new debugging tools; en- 
hanced speed; and modules, a pro- 
gramming concept found in Modula- 
2 and Ada. True BASIC supports 
color graphics for the Mac II as well 
as the 68881 math coprocessor. Pro- 
grams written in True BASIC on the 
Mac can also run on the IBM PC, 
Amiga, and Atari ST. The retail price 
of True BASIC 2.0 is $99.95. Owners 
of previous versions can upgrade to 
the new version at a cost based on 
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a sliding scale, depending on the 
date of original purchase. Reader 
Service No. 17. 

True BASIC Inc. 

39 South Main St. 

Hanover, NH 03755 

(604) 643-3882 


TurboGeometry Library, a new soft- 
ware tool for Macintosh program- 
mers who write graphics, engineer- 
ing, educational, and other programs 
that use geometry, has been released 
by Disk Software. The library 
comes with source code for more 
than 150 routines, including rou- 
tines that find the intersection of 
lines, polygons, arcs, and planes; de- 
termine the coefficients of the equa- 
tions of lines, circles, arcs, and 
planes; convert the coefficients of 
one equation to another; find the 
distance between points, lines, cir- 
cles, arcs, and planes; decompose a 
concave polygon into a series of 
convex polygons; and more. The li- 
brary sells for $99.95. Reader Service 
No. 18. 

Disk Software Inc. 

2116 East Arapaho, Ste. 487 
Richardson, TX 75081 

(214) 423-7288 


Mac Al 

ExperTelligence is now shipping 
two AI products for the Macintosh: 
ExperCommonOPss and ExperCom- 
mon LISP Foreign Function Inter- 
face. 

Some of the features of ExperCom- 
monOPS5 include a forward-chain- 
ing, rule-based, expert system lan- 
guage; a custom tracing mechanism 
of rule firings and changes to 
memory; the ability to pause, exam- 
ine memory, and undo rule firings 
to revert to an earlier state; confor- 
mation to the de facto OPS5 stan- 
dard described in Programming 
Expert Systems Using OPS5 (Brown- 
ston et al., Addison-Wesley); com- 
plete portability to other implemen- 
tations of OPS5; facilities to interface 
with other programming languages 
and tools; the ability to create com- 
plex Macintosh user interfaces for 
developed expert systems; and inte- 
gration with the most powerful Al 
development environments available 








today. ExperCommonOPs5 runs in 
both ExperCommon LISP for the 
Macintosh Plus and SE and Exper- 
Common LISP II for the Macintosh 
II, Version 2.2 or later. The retail 
price is $595. 

The ExperCommon LISP Foreign 
Function Interface is an add-on com- 
ponent of the complete ExperProfes- 
sional Development System. Users 
can create a new version of the Ex- 
perCommon LISP language that con-. 
tains functions written in any Macin- 
tosh Programmer's Workshop lan- 
guage: C, Pascal, or assembly lan- 
guage. Once the new version has 
been created, the foreign functions 
can be called from ExperCommon 
LISP in the same way as any other 
built-in function. The Foreign Func- 
tion Interface runs in ExperCom- 
mon LISP on the Macintosh Plus 
and the Macintosh SE and runs on 
the Macintosh II with ExperCom- 
mon LISP II. The price is $295. 
Reader Service No. 19. 
ExpertTelligence Inc. 

559 San Ysidro Rd. 
Santa Barbara, CA 93108 
(805) 969-7874 


Human Intellect Systems has an- 
nounced Instant-Expert Plus, a 
Macintosh expert system shell. In- 
stant-Expert Plus uses natural-lan- 
guage rule entry, interactive graph- 
ics, variables, and more than 18 dif- 
ferent inference engine search strate- 
gies. Hardware requirements are a 
Macintosh 512K with an external 
drive. Instant-Expert Plus retails for 
$498. Reader Service No. 20. 

Human Intellect Systems 

1670 S. Amphlett Blvd., Ste. 326 

San Mateo, CA 94402 

(415) 571-5939 


For the Atari ST and Amiga 
A new version of the Metacomco 
Toolkit is now available from Meta- 
comco. The toolkit consists of 11 
useful AmigaDOS commands that 
are stored in the C directory and 
can be used in the same way as the 
standard DOS commands. The new 
version also includes a Unix-based 
make utility and a touch utility. Com- 
mands included in the package are 
Pipes, Librarian, Disassembler, Auxil- # 
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iary CLI, Mount, Browse, Enlarge, 
Pack, Unpack, Make, and Touch. 
Metacomco Toolkit 1.2 works under 
Versions 1.1 and 1.2 of AmigaDOS 
and can augment the Metacomco 
shell. The price for the package is 
$49.95. Reader Service No. 21. 
Metacomco 

26 Portland Sq. 

Bristol BS2 8RZ 

England 

44-272-438781 


FTL Modula-2 for the Atari ST from 
Workman & Associates is now 
shipping. The Atari version is fully 
compatible with existing FTL pro- 
grams and includes a complete 
GEM interface. The package sells for 
$79.95. Reader Service No. 22. 
Workman & Associates 

1925 East Mountain St. 

Pasadena, CA 91104 

(818) 791-7979 


Miscellaneous 

MEMOCOM is now shipping a uni- 
versal cross-development kit for the 
Macintosh that includes a table- 
driven cross-assembler and a MEMU- 
LATOR I or MEMULATOR 16 in- 
circuit EPROM emulator. With the 
kit, developers can use the Macin- 
tosh to assemble and test sources 
programs for virtually any micro- 
processor/controller with 24 or less 
address bits. Both the universal 
cross-assembler and MEMULATOR 
{1/16 support industry-standard Intel 
hex, Motorola S-record, and straight 
binary formats. These output file for- 
mats are compatible with most 
serial EPROM programs. The MAC 
Universal Cross-Development Kit 
sells for $725 with a MEMULATOR II 
and $1,275 with a MEMULATOR 16. 
The kit is also available for PC-DOS 
and MS-DOS systems and the Atari 
ST. Reader Service No. 23. 
MEMOCOM 

1920 Arbor Creek Dr. 

Carrollton, TX 75010 

(214) 446-9906 


Addison-Wesley has released the 
Programmer's Online Companion by 
Steven Capps, a disk-based database 
reference to Inside Macintosh, Vol- 
umes 1-4, and the Apple Numerics 
Manual. The companion is a utility 
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program that allows programmers 
immediate access to bits of informa- 
tion from within any language devel- 
opment system and includes almost 
all the system calls, system globals, 
and assembly-language equates 
found in those volumes. The pro- 
gram controller resides in 5K RAM. 
The structure assumes a basic knowl- 
edge of Pascal or assembly language, 
Inside Macintosh, and the Macin- 
tosh itself. The package includes a 
3.5-inch disk and 32 pages of docu- 
mentation. It runs on the Macintosh 
Macintosh 


128K, Macintosh 512K, 





512Ke, and Macintosh Plus and sells 
for $34.95. Reader Service No. 24. 
Addison-Wesley Publishing Co. 

Rte. 128 

Reading, MA 01867 

(617) 944-3700 


Whitesmiths has announced CXDB, 
an interactive C source-level cross- 
debugger for the Motorola MC680x0 
line of processors. CXDB is a host- 
resident debugger available for the 
VAX and IBM PC that allows embed- 
ded 68K programs to be debugged 
in terms of the original C source 


“Developing my application in C would have taken 6 months to a year, but in Actor tt took 2 


months. ” 


“TH C ACTOR 


Oo 


or not 
to C...” 


—Brian Fenske, Boeing Commercial Airplane Company 


Actually, you don’t have to make the 
choice. Once C was ideal for all PC pro- 
gramming. But it has been complicated by 
windowing and graphical interfaces. Now 
windows development with C is difficult, 
time-consuming and error-prone. You 
need a new language that simplifies win- 
dows programming. Introducing Actor® 


Actor is the first interactive object-oriented language made for commercial development. 
Its powerful browsers, inspectors and debuggers give you more insight into a windowing 











environment than C ever will. But your C work is not lost. C libraries can be linked to Actor. 
Plus, its procedural syntax is easy for C programmers to learn. 


Actor comes with windowing classes built in. Customize Actor’s classes to create stand- 
alone windowing applications. And objects give you another layer of independence for a 
smooth transition to OS/2 and Presentation Manager. It’s the quickest and easiest way to write 


a windowing program. 


“You can write Windows programs much faster with Actor than with C or assembly language.” 
—PC Magazine, June 9, 1987 


Tech Specs 





Actor $495 ¢ Academic price $99 ¢ Academic site license $99 ¢ Manuals for site 
license $35 ¢ New! Language Extension $99 ¢ Shipping $5 US, $25 Int’l 
The Whitewater Group 
Technology Innovation Center 
906 University Place, Evanston, Illinois 60201 
(312) 491-2370 


Actor is a registered trademark of The Whitewater Group, Inc. 
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code. Features allow users to exe- 
cute host system commands; print 
the contents of a C variable function 
or file with or without assembly- 
language display; step through 
single or multiple lines until a spe- 
cific location is reached, again with 
or without assembly-language dis- 
play; create log output for later ex- 
amination; set and remove break- 
points on a specific C variable, line, 
or function; disassemble C source 
lines; obtain in-line help; display 
stack frames with or without type; 
and value information for variables 
in each frame. Prices for CXDB range 
from $1,800 to $7,000. Reader Service 
No. 25. 

Whitesmiths Ltd. 

59 Power Rd. 

Westford, MA 01886 

(617) 692-7800 


Optotech has introduced Laser Data- 
Bank, a “plug-and-play” 5'/4-inch 
write-once read-many (WORM) opti- 
cal drive subsystem for four popular 
computer environments: Sun Mi- 

crosystems’ Sun-3; DEC’s MicroVAX 
er ht la el ee 








_ 





II; IBM’s PC, PC/XT, and 286/386- 
based computers, including the PS/2 
and compatibles; and Apple's Macin- 
tosh SE and Macintosh II. The pro- 
prietary software also allows data 
exchange among all four subsystems 


by writing disks that can be read by | 


any Optotech drive. All the subsys- 
tems are built around the Optotech 
Model 5984 Optical Disk Drive with 
400 megabytes of storage per 5'/s- 
inch optical disk drive. Proprietary 
interface software in each subsys- 
tem makes the write-once drive im- 
mediately compatible with the host 
computer’s operating system and pro- 
vides standard file and disk manage- 
ment functions.. 

The price for the Macintosh Laser 
DataBank is $3,995. Single-unit 
prices for the Sun and VAX are 
$5,950 and $6,950, respectively. The 
Laser DataBank for PCs is currently 


available at a single-unit price of | 


$2,995. Reader Service No. 26. 
Optotech Inc. 

740-770 Wooten Rd. 

Colorado Springs, CO 80915-3518 
(303) 570-7500 











Reduce, from Northwest Computer 
Algorithms, is an interactive soft- 
ware system designed for general 
mathematical computations of inter- 
est to scientists, mathematicians, en- 
gineers, and university students. The 
system has been applied to a variety 
of problems in many different re- 
search areas, including quantum elec- 
trodynamics, quantum chromody- 
namics, electrical network analysis, 
plasma physics, celestial mechanics, 
general relativity, numerical analy- 
sis, and a variety of engineering prob- 
lems such as turbine and ship hull 
design. The code is portable across 
a wide range of machines. Reduce 
is now available for the following 
machines: VAX; Sun; Apollo; Macin- 
tosh; and IBM PC, PC/XT, PC/AT, and 
compatibles. A single-machine li- 
cense costs $495. Reader Service No. 
27. 

Northwest Computer Algorithms 
P.O. Box 1747 

Novato, CA 94948 

(415) 897-1302 


DDJ 


ADD TO THE POWER OF YOUR PROGRAMS WHILE YOU SAVE TIME AND MONEY! 
CBTREE does it all! Your best value in a B+tree source! 





Save programming time and effort. 

You can develop exciting file access programs quickly and easily because 
CBTREE provides a simple but powerful program interface to all B+tree 
operations. Every aspect of CBTREE is covered thoroughly in the 70 page 
Users Manual with complete examples. Sample programs are provided on 
disk. 


Gain flexibility in designing your applications. 

CBTREE lets you use multiple keys, variable key lengths, concatenated 
keys, and any data record size and record length. You can customize the 
B+tree parameters using utilities provided. 


Your programs will be using the most efficient searching techniques. 
B+trees use efficient search techniques that require fewer disk seeks than 
other methods. CBTREE guarantees an optimized maximum search path 
and always remains balanced. CBTREE is optimized for speed. You will 
be using a commercial quality, reliable and powerful tool. CBTREE is a full 


function implementation of the industry standard B+tree access method 
and is proven in applications since 1984. 


Access any record or group of records by: 

- its absolute position in the index (GETFRST and GETLAST), 
its relative location in the index (GETPRV, GETNXT and GETSEQ), 
an exact match to a key (GETREC), 
a partial match to a key (GETPAR, GETALL and GETKEYS) 
a lexical relation to a key (GETLT, GETLE, GETGT and GETGE). 
You may also add, delete and update any record without the need to 
reorganize the index (INSERT, ISRTKY, DELETE, DELTKY and 
NEWLOC). 

¢ Block retrieval calls speed up sequential processing. 


Increase your implementation productivity. 
CBTREE is over 6,000 lines of tightly written, commented C source code. 
The driver module is only 20K and links into your programs. 


Port your applications to other machine environments. 

The C source code that you receive can be compiled on all popular Cc 
compilers for the IBM PC and also under Unix, Xenix, and AmigaDos! No 
royalties on your applications that use CBTREE. CBTREE supports multi- 
user and network applications. 


CBTREE IS TROUBLE-FREE, BUT IF YOU NEED HELP WE PROVIDE FREE PHONE SUPPORT. 
ONE CALL GETS YOU THE ANSWER TO ANY QUESTION! 





ae aN 


PEACOCK SYSTEMS. INC 


CBTREE compares favorably with other software selling at 2,3 and 4 times our price. 
Sold on unconditional money-back guarantee. 
YOU PAY ONLY $99.00 - A MONEY-SAVING PRICE! 
TO ORDER OR FOR ADDITIONAL INFORMATION 
CALL (703) 356-7029 or (703) 847-1743 


OR WRITE 
Peacock Systems, Inc., 2108-C Gallows Road, Vienna, VA 22180 
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The software technology available to 
programmers of IBM-compatible per- 
sonal computers is truly amazing. And 
newer, more powerful development 
packages appear all the time. But until 
now, finding out about these important 
products has been a difficult and time 
consuming task. 


FREE Buyer’s Guide. The New Pro- 


Upgrade your technology 


Noncommissioned Staff. Our courteous 
salespeople are always ready to help 
you. And if you aren’t sure about your 
needs, our knowledgeable technical 
people can give you sound, objective 
advice. 


Experience. We've specialized in de- 
velopment software for |IBM-compatible 
personal computers since 1984 and 





are experienced at providing a full 
range of quality products and customer 
services. 


How to Get Your Copy. There are three 
ways for you to receive your FREE 
copy of the Programmer’s Connection 
Buyer’s Guide: 1) Use the reader service 
card provided by this journal; 2) Mail us 
a card or letter with your name and 





grammer’s Connection Buyers 
Guide contains individual des- 
criptions of over 500 titles of 
programmer's development 
software by over 150 manu- 
facturers. Each. description 
covers major product features 
as well as any software or 
hardware requirements and 
version numbers. In the box on 
the right are some examples of 
the types of descriptions you'll 
find in our Buyer’s Guide. 


No Hidden Charges. The low 
discount prices in our Buyer's 
Guide are all you pay. We don’t 
charge extra for domestic UPS 
Ground shipping, credit cards, 
COD orders, purchase orders, 
sales tax (except Ohio) or 
special handling (except for 
non-Canadian international 
orders). 


Guarantees. We offer FREE 
30-day no-risk return guaran- 
tees and 30-day evaluation 
periods on most of our 
products. 


Latest Versions. The products 
we carry are the latest versions 
and come with the same manu- 
facturer’s technical support as 
if buying direct. 


Large Inventory. We have one 
of the largest inventories of 
programmer’s development 
products in the industry. Most 
orders are shipped within 24 
hours. 


The 






Limited Time Only! 


Sale Prices 


on ISAM 
File Managers 
through 1/31/88 


FairCcom 


c-tree in C Source Code 
List $395 Reg $315 Sale $289 


c-tree with r-tree 
List $650 Reg $519 Sale $499 


These fast and highly portable B+Tree 
functions provide multi-key ISAM file 
management for C a bah There are 
low level functions for directly accessing 
data and index files and high level func- 
tions for creating and manipulating ISAM 
files. The highly portable C source code 
can be compiled with almost any C com- 
piler or computer for single-user, multi- 
user or network applications. It supports: 
record locking for multi-users; fixed and 
variable length records; fixed and variable 
— keys with key compression; re-use 
of deleted record space; duplicate and 
unique = fields; and more. The pack- 
age includes a complete family of setup 
and maintenance utilities, unlimited tech- 
nical support, no ee and free 
hardcopy listings of release updates. r- 
tree is an optional report generation utility 
for c- tree that permits complex, multi-line 
reports to be produced from single or 
multiple c-tree data files. 

Supports all commercial grade C com- 
= Requires 128K memory. Version 
4.1F. 








Lattice 


dBC ITI Plus 
List $750 Reg $594 Sale $499 


With Library Source 
List $1500 Reg $1184 Sale $998 


Use the Lattice dBC Ill Plus library of func- 
tions to write fast C language programs 
to create, access and update files that are 
compatible with Ashton-Tate’s dBASE Ill 
PLUS database management system. 
dBC Ill Plus is network ready with func- 
tions that solve complicated network 
database problems. These functions let 
you lock files or records automatically or 
manually, prevent you from accidentally 


address; or 3) Call one of our 
convenient toll free telephone 
numbers. 





oe files or records that are already 
locked, and allow you to test whether files 
or records are locked or free. You can 
share your ISAM files with as many sta- 
tions as are possible on your network. 
ey re (current version): 
Borland Turbo C, Lattice C, or Microsoft 
C. Requires 128K memory. Version 1.0. 


SoftCraft 





If you haven’t yet received 
your Programmer’s Connec- 
tion Buyer’s Guide, act now. 
Upgrading your programming 
technology could be one of 
the wisest and most profitable 
























Btrieve decisions you'll ever make. 
List $245 Reg $184 Sale $169 
Xtrieve igen tt 
List $245 Reg $184 Sale $169 CALL TOLL FREE 
Report Option USA: ......... 800-336-1166 
List $145 Reg $99 Sale $89 | Canada: ...... 800-225-1166 
Btrieve/N Ohio & Alaska 
List $595 Reg $454 Sale $429 (Collect): .. 216-494-3781 
Xtrieve/N 
List $595 Reg $454 Sale $429 iiereationak. 316 maa ant 
Report Option/N nternational: - - 
List $345 Reg $269 Sale $249 
ment system for use with most progr | Telex: .......... 9102406879 
ming languages. Btrieve allows a file 
structure with: record length up to 4K 





Easylink: .......... 62806530 


bytes (64K in some environments); up to 
24 different keys per file; maximum key 
size of 255 bytes; a maximum file size of 
over 4 billion bytes; and file size limited 
only by physical a capacity and 
operating system limitations. Duplicate, 
modifiable, null and segmented keys are 
allowed and there is no limit to the num- 
ber of files n at one time. Written in 
8088 assembly language for maximum 
efficiency, Btrieve uses extensive cache 
buffering to optimize performance and 
pre-imaging to automatically recover 
damaged files. Transaction bracketing 
and automatic record locking allow you 








Programmer’s Connection 
7249 Whipple Avenue NW 
North Canton, OH 44720 









to guarantee the integrity of your data 
files despite the concurrency problems 
that arise in a network. The optional 
Xtrieve is a menu-driven query system 
that enables Btrieve users to access 






Btrieve files without writing a program. 
The Report Option for Xtrieve allows you 
to easily generate reports. 

Specify single-user or multi-user/net- 
work version. For multi- user/network ver- 
sion, specify environment: 3Com3plus; 
IBM TopView; Microsoft Windows; Multi- 
link Advanced; MPOS; Novell Advanced 
NetWare; XENIX em V/AT; or satellite 
or server-based IBM PC Network. Btrieve 
supports most language compilers and 
interpreters. Requires hard disk and 
128K memory (Btrieve routines use 32K). 
Version 4.10. 
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Turbo Lightning Word Wizard................ 70 


ai-expert systems List Ours 
Ist-CLASS by Programs in Motion .............. 495 399 
EXSYS Development Software by EXSYS.......... 395 289 
EXSYS Runtime System.................... 600 469 
LEVELS dy /nformation Builders ................ 685 569 
Logic-Line Series A// varieties hy Thunderstone..... CALL CALL 
VP-EXPERT dy Paperback Software ......... New 125 79 
ai- lisp language 
muLISP-87 Interpreter by Soft Warehouse .... New 250 CALL 
muLISP-87 Interpreter & Compiler.......... New 350 CALL 
‘ Q'Nial Various by MAL Systems ...............-. CALL CALL 
Star Sapphire LISP Compiler hy Sapiens.......... 495 429 
TransLISP PLUS from Solution Systems .......... 195 125 
ai- prolog language 
Arity Combination Package ................... 1095 979 
Expert System Development Pkg ............. 295 229 
File Interchange Toolkit.................... 50 a4 
PROLOG Compiler & Interpreter ............. 650 569 
Screen Design Toolkit... 0... cece cccenns 50 44 
SQL Development Package ................. 295 229 
Arity PROLOG Interpreter .................... 285 - 229 
PEAY SUMING FIGID woo iic sce cedaulie cies 95 77 
LPA microPROLOG A// Varieties................ CALL CALL 
MPROLOG Language Primer LOG/CWARE......... 50 45 
MPROLOG P500 by LOGICWARE ............5.. 495 395 
MPROLOG P550 w/Primer by LOGICWARE ....... 220 =175 
Turbo PROLOG dy Borland Intl ................. 100 64 
Turbo PROLOG Toolbox Ay Borland /nt/........... 100 64 
ai- smalitalk language 
NE id pron ones eae yy Seve keane 100 84 
EGA/VGA Color Option .................... 50 45 
Goodies Diskette #1 ...................... 50 45 
DUNO 5d sihsteyeah. wtb dak cn tiebne 50 45 
ai- texas instruments 
Arborist Decision Tree Software ................ a 
es UME TT oo oe Gov. chee oc Ade Peeeaehe 95 77 
Personal Consultant Easy..................... 495 435 
Personal Consultant Image.................... 495 435 
Personal Consultant Online ................... 995 869 
Personal Consultant Plus..................... 2950 2589 
Personal Consultant Runtime .................. 9 84 
ada language 
AdaVantage GSA-validated by Meridian Software ... 795 735 
AdaVantage Utility Packages ................ 50 47 
DOS Environment Package ................. 50 47 
Ada GSA-validated w/maintenance by alsys ... New 3355 3119 
Janus/ADA C Pak by R&A Software............. 95 84 
apl language 
BPE PO RVG. 6 5.0 ciel end dees eds os ies 695 495 
APL*PLUS PC Spreadsheet Mgr by S7TSC ........ 195 139 
APL*PLUS Tools by SISO... occire ccc eieie ces 295 1998 
APR PER OP EOP SIO 6 x ocak aig ese ee iss ten 695 495 
ATLAS*GRAPHICS by STSC .................. 450° = 329 
Financial/ Statistical Library by S7TSC ............ Zid. ‘183 
POEROUREL OP SISC 5c ccdaSescdicSeneiedecu ds 95 69 
SIATGRAT INC OOP SIDE iwi swadiwcewseww ed 895 649 
assembly language 
386 ASM/LINK Cross Asm hy Phar lap .......... 495 389 
8088 Assembler w/Z-80 Translator by 2500AD.... 100 89 
ASMLIB Function Library by BCSoft ............. 149 «+125 
asmTREE 8-7ree Dev System by BCSoft .......... 395 ~ 329 
Cross Assemblers Various by 2500 AD ........... CALL CALL 
EZAS PV SONER) 6. < oo nisin aa vow awa ng anes 70 59 
Microsoft Macro Assembler................... 150 CALL 
Resident-ASM by American Software Int! ..... New 150 139 
Turbo Debugger by Speedware................. 89 79 
Turbo Editasm by Speedware .................. 99 84 
Visible Computer: 8088 by Software Masters ...... 80 64 
basic language 
db/Lib for QuickBASIC by AJS Publishing ......... 139 119 
Finally by Komputerwerk ...........0 0000000055 99 85 
WEREtE Ce POTIONS a isd ss Sethe eee 69 55 
Microsoft QuickBASIC............. New Version 99 CALL 
OBase Ae/ational Database by Crescent .......... 89 79 
SUCe ROUEN DF TCO oo Sioned 3 dk a's env ne 130 ©=109 
QuickPak by Crescent Software ................ 69 59 
Scientific Subroutine Library by Wiley ........... 125 99 
Screen Sculptor by Software Bottling ............ 125 91 
Stay-Res by MicroHelp ... 0.2... 0.0 69 55 
ROO See a vas IR Fie Clot news 100 79 
True BASIC w/Run-time ........... Special Price 150 99 
True BASIC 3D Graphics..................... 50 41 
True BASIC Developer's Toolkit................ 50 41 
Turbo BASIC Compiler by Borland Int] ........... 100 64 
blaise products 
ASYNCH MANAGER Specify C or Pascal ......... 175 135 
G POLS-PLUS/SG « .. doc eevee ssaneaeves 129 99 
KeyPlayer Super Batch Program ................ 50 45 
LIGHT TOOLS for Datalight C.................. 100 65 
PASCAL TOOLS © FOUGsee . los iw se a hwcass 175 38135 
RMON’ Feat FOF oe e ngs Pewee eae ets 50 45 
TURGO ASTM PLUS occ. nk nc ccc cee ees 129 99 
ede ah a ee a 129 99 
TURBO POWER TOOLS PLUS................. 129 99 
VIEW MANAGER Specify C or Pascal. ........... 275 199 
borland products 
EUREKA Couation SoWer . . . 00.80 cand daewets 167 105 
HNN C1 POINTE... 5 6 ons ais ersinln co mmeu eaed 150 99 
UNM oh ONS «lnc ok ow hd Gants ea tee 85 57 
NUN nes EP Hcl: it ie tan Sow wp dae aes 100 64 
TERE NE 6 Son oo fs 100 64 
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Turbo Basic Telecom Toolbox.................. 100 64 
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Turbo Lightning and Word Wizard .............. 150 94 
LUCMOSORMIMD 2 2 0 Soe te o's nee alos oe 100 5 
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Turbo Pascal Database Toolbox................ 100 
Turbo Pascal Developer's Toolkit............... 395 
Turbo Pascal Editor Toolbox................... 100 
Turbo Pascal Gameworks Toolbox .............. 100 
Turbo Pascal Graphix Toolbox ................. 100 
Turbo Pascal Numerical Methods Toolbox ........ 100 
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C-terp by Gimpel, Specify compiler.............. 298 
C Trainer with Book by Catalytix................ 122 
DeSmet C w/Debugger & Large case ............ 209 
DeSmet C w/Debugger only .............-.04-. 159 
Eco-C88 Modeling Compiler by Fcosoft ...... New 100 
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Microsoft C Compiler 5.0 w/CodeView .......... 450 
Microsoft QuickC Compiler ................... 99 
Optimum-C by Datalight ............ 200 eee eee 139 
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RM/FORTRAN by Ayan-McFarland.............. 599 
Scientific Subroutine Library by Wiley ........... 175 
Statistician by Alpha Computer Service ........... 295 
AL OF WOES as ons danske erclnanweas 295 
SERIO OCS OY WHEY 5 ioscan nee nea baiaorn oh 295 
Strings & Things by Alpha Computer Service ....... 70 
greenleaf products 
Greenleaf C Sampler Specify Quick€ orTurbo C..... 95 
Greenleaf Comm Library ..................... 185 
Greenleaf Data Windows Library ............... 225 
Wie SOURS COE. oo oo ec nia.man ss Daan nt, o- 395 
Greveen! FQNCGINE. -,. 2.4... ssadd se a 185 
help utilities 
HELP /Comtial by B97S 5... ooo ae ois we ete eRe 125 
On-line Help from Opt-Tech ................... 149 
SoftScreen/HELP dy Dialectic Systems .......... 195 
lattice products 
Lattice C Compiler ver 3.2 from Llattice........... 500 
with Library Source Code ..............2000. 900 
C Cross Reference Generator.................. 50 
Wie SU SHE as FS ese ey te 200 
C-Food Smorgasbord Function Library............ 150 
WH SONED CODE... Soc 2250 = wae ee Oe & 300 
C-Sprite Source Level Debugger ................ 175 
Corset Soven Manager... 65. escecc cece cst es'ews 125 
NP SOMIP LOUD occ dc cdeei tds bvabadacn 250 
MGI tis eo sGnweat cand Ouse awake celcudy 250 
Oe EN OOS ons sel wh dade de ewan ee aden 500 
ttn tig tc x ae dd ade eeu ee 750 
ST OE COUN ios oo vin wwe a Un sine nwas cu 1500 
A oo 8 cee oil tins Sa ou ee 195 
RPG Il Combo A// three items below............. 1100 
RPG II Compiler Wo Aoyalties................ 750 
SEU Searce Entry Utility «owe bees ence 250 
DOE POSES. «3 ccs cod es 3S a 250 
Screen Design Aid Utility for APG // .. 2.2... eee. 350 
SecretDisk Il Encryption Utility. .............4.. 79 
SideTalk Resident Communications .............. 120 
SSP/PC Scientific Subroutine Library ............ 350 
Text Management Utilities .................... 120 
metagraphics products 
ee eee ka ered 95 
LightWINDOW/C for Datalight C ...........--+-- 95 
MetaWINDOW Wo Aoyalties............---445- 195 
UOTE PLS 28 USE ok oe oa es 275 
TurboWINDOW/C for Turbo C ... 2... ee ee ee 95 
TurboWINDOW/Pascal for Turbo Pascal ......... 95 
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Miorecreous COBOL/2 ... 1... keke aes 
Micro Focus COBOL/IQ Ad hoc Report Writer ..... 
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Level Il Animator .....................0055 
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PAWMCIO/ SEE scéides Hayes asc <.sinew ce ty wat 
Micro Focus Personal COBOL ................. 
Micro Focus Professional COBOL .............. 
Micro Focus SOURCEWRITER................. 
Micro Focus VS COBOL/XENIX ............... 


microport products 


386 Unlimited License Kit .................... 
AT Unlimited License Kit ..................... 
DOSMerge286 Specify 2-Users or Unlimited... .... 
DOSMerge386 2-Users ..... 0.0... eee eee 
DOSMerge386 Unlimited Users ................ 
System V/386 Combination................... 
jou tmeene System... 5... i kek dsa te. 
386 Software Development System ........... 
Text Preparation System ................... 
System V/AT Combination.................... 
PT -TOMUUNE DVS ch ice es veep weeaeds 
AT Software Development System ............ 
Text Preparation System ................... 


microsoft products 


Microsoft BASIC Compiler for XFW/X ............ 
Microsoft BASIC Interpreter for XFW/X........... 
Microsoft C Compiler 5.0 w/CodeView........... 
Microsoft COBOL Compiler with COBOL Tools...... 

FE IIE on iss yee ate ntks whe aM emegid & 
en es New 
Microsoft FORTRAN Optimizing Compiler ......... 
Microsoft FORTRAN for XEM/X................. 
Microsoft Learning DOS ..................... 
Microsoft Macro Assembler................... 
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with Microsoft Windows ...............-+44+ 
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Microsoft Pascal Compiler.................... 
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LOGITECH Modula-2 Development System........ 
Modula-2 Compiler Pack ................... 
Meeee-2 TOONS .5.d cesses ccewies owekas 

LOGITECH Modula-2 Window Pkg.............. 

Macro2 Macro preprocessor by PM/ ............. 
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MODULA-2 by Stony Brook ............... New 
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Science & Engrg Tools by Quinn-Curtis........... 
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mouse products 
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OPT-Tech Sort by Opt-Tech Data Proc ........... 
PC-MOS/386 by The Software Link ......... New 
PC/TOOLS by Custom Software Systems ......... 
Resident Expert Specify /ang by Santa Rita .... New 
Screen Machine by MicroHelp ............----- 
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PolyXREF One /anguage only .................. 129 
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Source Print by A/debaran Labs ...............-. 97 
TLIB Version Control System by Burton ........... 100 
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Complete XENIX System V by SCO.............. 1295 
Development System ...................... 595 
Operating System Specify XT or AT............ 595 
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Report Option for Xtrieve ................-.. 145 
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dBrief Customizes Brief for dBASE Ill........... 95 
OO OV RUN FDI oe 5s cece e es Mi Sa eh oan s 75 
Epsilon Emacs-like editor by Lugaru.............. 195 
KEDIT by Mansfield Software ..........6 00000 ee 125 
Micro/SPF by PHASER SYSTEMS .............. 175 
ele i EE ER ER ETE 450 
PC/VI by Custom Software Systems ............. 149 
SPF/PC by Command Technology Corp........... CALL 
Vedit Plus by CompuView .............0 cee eaee 185 
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ALICE /nterpreter by Software Channels .......... 95 
AZATAR DOS Toolkit by AZATAR........... New 95 
DOS/BIOS & Mouse Tools by Quinn-Curtis........ 75 
Flash-up by Software Bottling............5. New 89 
Flash-up Developer's Toolbox.............. New 49 
MACH 2 for Turbo Pascal by Micro Help .......... 69 
MetraByte D/A Tools by Quinn-Curtis............ 100 
Science & Engrg Tools by Quinn-Curtis........... 75 
Screen Sculptor by Software Bottling ............ 125 
Speed Screen by Software Bottling.............. 35 
System Builder by Royal American .............. 150 
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TurboRef by Gracon Services ............2.005- 50 
TURBOsmith Source Debugger by Visual Age ...... 99 
Universal Graphics Library by Quinn-Curtis ........ 130 
wendin products 
Operating System Toolbox .................... 99 
PCNX Operating system ......... 0... c eee eee 99 
PCVMS Similar to VAX/VMS «20... ce cece 99 
Wendin-DOS Multitasking DOS... ...........4-- 99 
XTC Text Editor w/Pascal source .........6.0055 99 
xenix/ unix products 
Btrieve /SAM File Mgr by SoftCraft ............4.. 595 
eg, er at ee ee eee 498 
c-tree /SAM Mor by FairCom ..........-. 0000 es 395 
dBx with Library Source by Desktop Al.........-.- 550 
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LOWEST PRICES 
Due to printing lead times, some of our current 
prices may differ from those shown here. Call for 
latest pricing. 

FREE SHIPPING 
Orders within the USA (including Alaska & Hawaii) 
are shipped FREE via UPS. Express shipping is 
available at the shipping carrier's standard rate 
with no rush fees or handling charges. To avoid 
delays when ordering by mail, please call first to 
determine the exact cost of express shipping. 


CREDIT CARDS 
VISA and MasterCard are accepted at no extra 
cost. Your card is charged when your order is 
shipped. Mail orders please include credit card 
expiration date and authorized signature. 


CODs AND POs 
CODs and Purchase Orders are accepted at no 
extra cost. No personal checks are accepted on 
COD orders. POs with net 30-day terms (with initial 
minimum order of $100) are available to qualified 
US accounts only. 


| SALES TAX 
Orders outside of Ohio are not charged state sales 
tax. Ohio customers please add 6% Ohio tax or 
provide proof of tax-exemption. 


INTERNATIONAL ORDERS 

Shipping charges for International and Canadian 
orders are based on the shipping carrier s standard 
rate. Since rates vary between carriers, please call 
or write for the exact cost. International orders 
(except Canada), please include an additional $10 
for export preparation. All payments must be made 
with US funds drawn ona US bank. Please include 
your telephone number when ordering by mail. Due 
to government regulations, we cannot ship to all 
countries. 


VOLUME ORDERS 
Volume orders may qualify for additional discounts. 
Call us for special pricing. 


SOUND ADVICE 
Our knowledgeable technical staff can answer 


technical questions, assist in comparing products 
and send you detailed product information tailored 
to your needs. 
30-DAY GUARANTEE 
Most of our products (excluding books) come with 
a 30-day documentation evaluation period or a 
30-day return guarantee. Please note that some 
manufacturers restrict us from offering guarantees 
on their products. Call for more information. 
MAIL ORDERS 

Please include your telephone number on all mail 
orders. Be sure to specify computer, operating 
system and any applicable compiler or hardware 
interface(s). Send mail orders to: 

Programmer’s Connection 

7249 Whipple Ave. NW 
North Canton, OH 44720 


Nahe Rernesinentyiinietetis 800-336-1166 
CANADA .__..................... 800-225-1166 
OHIO & ALASKA (Collect) 216-494-3781 
UNIS crectoeriien deaspecncticcnarel 9102406879 
EASYLINK ow... 62806530 
INTERNATIONAL ............ 216-494-3781 


CUSTOMER SERVICE ... 216-494-8899 
Hours: Weekdays 8:30 AM to 8:00 PM EST. 





FORUM 


It will be seen that this mere pains- 
taking burrower and grub-worm of a 
poor devil of a sub-sub appears to 
have gone through the long Vaticans 
and street-stalls of the earth, picking 
up whatever allusions to whales he 
could anyways find in any book what- 
soever, sacred or profane. Therefore 
you must not, in every case at least, 
take the higgledy-piggledy whale state- 
ments, however authentic, in these 
extracts, for veritable gospel ce- 
tology. 

—Herman Melville. 
hab, standing on the deck of 
Pequod and searching for the 

great white whale, overlooked the 
real monster. 

Ben, an editor for another maga- 
zine, recently moved to the West 
Coast. Drawn by the California curls, 
he went out to walk the waves. Last 
week the ocean drove his surfboard 
into his face. 

It's been nearly seven years since 
I moved to the Coast, but I still walk 
out on the rocks regularly to stand 
in awe of the big blue beast. 

At last fall’s Comdex, IBM rolled 
in with an announcement of the 
delivery of OS/2 and word that it will 
be promoting its proprietary Ex- 
tended Edition of OS/2 over the Stan- 
dard Edition. The Comdex daily de- 
clared the show Very Blue, while 
several frolicking whales spouted 
their support. 

Among the whales, Lotus Devel- 
opment Corp. announced Agenda. 
Agenda is the information manager 
that Jerry Kaplan went to Lotus to 
develop. It is what he calls an item/ 
category database: the items are 
short, free-form, textual entities, 
which the user can assign to points 
in a user-defined, evolving hierarchy 
of categories. Agenda could be 
wildly successful if it sufficiently 
models the naive view of computers 
held by many pre-users: that one 
should be able to type arbitrary in- 
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formation into the machine and re- 


trieve it on demand. 7 
Ashton-Tate’s chairman, Ed Esber, 
had left no doubt as to who would 
define the dBASE standard when he 
dared dBASE add-on and compiler 
vendors to “make his day,’ which 
they could do by challenging A-T’s 
claim on the dBASE language (the 
language itself, not just A-T’s im- 
plementation). So it came as no sur- 
prise to see Marty Winston of 
Wallsoft at Comdex handing out 
make-my-day buttons decorated 
with the international red-circle-and- 
backslash negation symbol. (It was 
Winston who brought dBASE after- 
market companies together in a 
dBASE Standards Committee.) Can a 


language definition be a product? - 


Esber has not only thrown down 
the gauntlet to the aftermarket com- 
panies but also challenged the indus- 
try to deal with this tricky question. 

Despite the lukewarm response to 
IBM's RT, you can find RISC technol- 
ogy implementations for just about 
any broad-based hardware. Shortly 
before Comdex, Sun announced its 
SPARC (Scalable Processor ARChitec- 
ture) RISC architecture and by 
Comdex had licensed the technol- 
ogy to over 40 companies, including 
Arete. Products based on the Inmos 
transputer parallel RISC processors 
are also proliferating. Atari, which 
incidentally would have won any 
Most Outrageous Product Name at 
Comdex competition with its Moses 
Promiselan, demonstrated a_ proto- 
type of the Abaq transputer, which 
can act as a backend for an Atari ST 


and provide mondo MIPS number 
crunching and near-photographic 
graphics. Levco, now a division of 
Scientific Micro Systems, announced 
the formation of a _ TransLink 
Transputer Developers Group to sup- 
port developers using its transputer 
modules in Macs. 

Comdex offered a few new imple- 
mentations of familiar languages. 
Ryan-McFarland, now a division of 
Austec, announced an OS/2 version 
of its ANSI-77 FORTRAN, Lahey of- 
fered -a PC ANSI-77 FORTRAN for 
$95, and Prospero had an ANSI-77 
FORTRAN for GEM. A number of 
new Modula-2 implementations or 
versions were announced, including 
a new version of the well-regarded 
Logitech compiler, new FTL versions 
for several machines, and OXXI’s 
Benchmark Modula-2 for the Com- 
modore Amiga. California Software 
Products has ported RPG II to PCs. 
And Borland unloaded a number of 
language announcements, including 
Turbo Pascal 4.0. 

Meanwhile amid the flotsam and 
jetsam of the show, I kept sighting 
ex-editors of ex-programmers’ maga- 
zines who had jumped ship as their 
magazines sailed into strange 
waters. Finally, heading for the press- 
room one last time, I ran into Scott 
Mace, who, having been with In- 
foWorld since before I moved to the 
Coast, must be the longest-tenured 
scribe for any personal computer 
industry publication. A real journal- 
ist and a survivor. 

And Ben was in the pressroom, 
the stitches now out, working on his 
notes. 


Glee. Susodg 


Michael Swaine 
editor-in-chief 
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Screens, the Visible Part 
of Your Program. 


A program is often judged by how well 
the screens are executed. However, 

the real creativity lies in what goes on 
behind the screens. 


ScreenStar is a product that allows your 
real creativity to light up the screen. It 
reduces costly screen, window, and data 
validation development time. 


You Take the Bows, We 
Write the Code. 


Our natural drawing commands allow 
you to paint any screen imaginable. 
Press one key when you are satisfied and 
ScreenStar produces concise, commented, 
ready-to-compile code. This allows 
immediate testing of the I/O screens, 
including smooth, even scrolling 
between multiple screens. 





Create or capture complex screens with 
data-entry filters built in. 


If all ScreenStar did was turn screens 
into code it would be a useful tool. Yet 
ScreenStar also permits a wide range of 
field types. Some of the choices include 
date, alphanumeric, telephone, yes/no, 
dollar, time and user-definable fields. 


Other valuable data-entry filters are 
built in, such as required field, display 
only, and many others. All screen fields 
are generated with error-checking routines. 
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ScreenStar is a trademark of Essential Software Inc. 
Dan Bricklin’s Demo Program is a trademark of Software Garden Inc. 





ScreenStar Not Only Captures 
Your Imagination, 
It Captures Screens. 
The memory-resident capture program 
converts any screen into a ScreenStar 
file in seconds, including those generated 
by programs like Dan Bricklin’s Demo 
Program. 


* Interactive screen painting and 
subsequent code generation. 


* Multiple screen design and scrolling. 


* TSR screen capture program, works 
with any program including Dan 
Bricklin’s Demo Program. 


* Complete window design including 
Overlapping window functions. 


ScreenStar Sets the Stage 
for Windows. 


ScreenStar comes with a complete 
window generating library. You design 
the help screens and pop-up windows. 


* Screens are compressed into data 
structures, and remain a permanent part 
of the program. No messy data files to 


Essential ScreenStar windowing look for. 

functions tie them together in one 

smooth package. Price ™ $ 99 
Curtain Call. W/Source add $99 

They may not ask for your autograph, 

but they will want to know how you did Audition Our Product 

those screens. Screenstar is more than a Today. Call: 


screen-painting program. It is a 
screen processor. No professional 
programming environment will 
be complete without 
this product. 





Aaah. 


We know you will enjoy 
using ScreenStar. However, 
should you give it less than 
rave reviews, return it 
within 30 days for a full 
refund. 


DEE Ya 


Essential Software 

South Orange Plaza 

76 South Orange Ave., Suite 3 
South Orange, NJ 07079 








Whatever dialect of IBM you need to speak, 
CROSSTALK® Mk. 4 makes the connection. 
Now, one program does the job that used to require several. 


CROSSTALK® Mk. 4 allows high-speed direct communications 
between PCs and minicomputers, or (with an IRMA™ board) 





















can support all of these sessions (and others) simultaneously, 
and display each session in its own window. 
CROSSTALK Mk. 4 emulates all the terminals you’re likely 
to find useful. That includes IBM 3101 (page and character 
modes), IBM 525x, IBM 529x, IBM 327x, as well as many 
popular async terminals like the DEC VT100 and VT220 
series. CROSSTALK Mk. 4 includes the powerful CASL™ 
programming language, which allows you to automate 
communications applications quickly and easily. 
So if you’re used to thinking of CROSSTALK just to 
use with a modem, you’re missing some important 
connections. Ask your dealer for details, or write: 


eee Digital Communications Associates, Inc. 
1000 Holcomb Woods Parkway / Roswell, Georgia 30076 
1-800-241-6393 


CRO TALK’ 


COMMUNICATIONS 
VS 


CROSSTALK and DCA are registered trademarks of Digital Communications 
Associates, Inc. IRMA, Smart Alec and CASL are trademarks of Digital Communi- 
cations Associates, Inc. IBM is a registered trademark of International Business 

Machines Corp. DEC is a registered trademark of Digital Equipment Corp. 


aro eth, 
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between your PC and an IBM Mainframe, or (with Smart Alec™) 
between your PC and IBM System 3x’s. If you like, CROSSTALK 


